scai 0.1.50 → 0.1.51

package/README.md

@@ -1,16 +1,15 @@
-# ⚙️ scai — Smart Commit AI ✨
+# ⚙️ scai — Smart Commit & Review AI ✨
 
+> AI-powered CLI tool for commit messages **and** pull request reviews — using local models.
 
-> AI-powered CLI tool for commits and summaries — using local models.
+**scai** is your AI pair‑programmer in the terminal. Focus on coding while scai:
 
-
-**scai** is a privacy-first, local AI assistant for developers. It brings semantic understanding to your codebase, directly from the terminal:
-
-- 💬 Suggest intelligent Git commit messages  
-- 🧐 Summarize files in plain English  
-- 📜 Auto-update your changelog  
-- 🔍 Search and ask questions across your codebase (ALPHA)  
-- 🔐 100% local — no API keys, no cloud, no telemetry
+- 🤖 **Reviews open pull requests** and provides AI‑driven feedback (BETA)  
+- 💬 **Suggests intelligent Git commit messages** based on your staged diff  
+- 📝 Summarizes files in plain English  
+- 📜 Auto‑updates your changelog  
+- 🔍 (ALPHA) Search & ask questions across your codebase  
+- 🔐 100% local — no API keys, no cloud, no telemetry  
 
 ---
 

package/dist/commands/ReviewCmd.js

@@ -0,0 +1,178 @@
+import readline from 'readline';
+import { reviewModule } from '../pipeline/modules/reviewModule.js';
+import { fetchOpenPullRequests, fetchPullRequestDiff, getGitHubUsername, submitReview } from '../github/github.js';
+import { getRepoDetails } from '../github/repo.js';
+import { ensureGitHubAuth } from '../github/auth.js';
+// Function to fetch the PRs with requested reviews for a specific branch (default to 'main')
+export async function getPullRequestsForReview(token, owner, repo, username, branch = 'main', filterForUser = true) {
+    const prs = await fetchOpenPullRequests(token, owner, repo);
+    const filtered = [];
+    const failedPRs = [];
+    for (const pr of prs) {
+        const isDraft = pr.draft;
+        const isMerged = pr.merged_at != null;
+        const shouldInclude = !isDraft &&
+            !isMerged &&
+            (!filterForUser || pr.requested_reviewers?.some(r => r.login === username));
+        if (shouldInclude) {
+            const diffUrl = `https://api.github.com/repos/${owner}/${repo}/pulls/${pr.number}.diff`;
+            try {
+                const diffRes = await fetch(diffUrl, {
+                    headers: {
+                        Authorization: `token ${token}`,
+                        Accept: 'application/vnd.github.v3.diff',
+                    },
+                });
+                if (!diffRes.ok) {
+                    throw new Error(`${diffRes.status} ${diffRes.statusText}`);
+                }
+                const diff = await diffRes.text();
+                filtered.push({ pr, diff });
+            }
+            catch (err) {
+                console.warn(`⚠️ Could not fetch diff for PR #${pr.number}: ${err.message}`);
+                failedPRs.push(pr);
+            }
+        }
+    }
+    if (failedPRs.length > 0) {
+        console.warn(`\n⚠️ Skipped ${failedPRs.length} PR(s) due to diff fetch failures:`);
+        for (const pr of failedPRs) {
+            console.warn(`  - #${pr.number}: ${pr.title}`);
+        }
+        console.warn('These PRs will not be included in the review summary.\n');
+    }
+    return filtered;
+}
+// Ask user to pick a PR to review
+function askUserToPickPR(prs) {
+    return new Promise((resolve) => {
+        if (prs.length === 0) {
+            console.log("⚠️ No pull requests with review requested.");
+            return resolve(null);
+        }
+        console.log("\n📦 Open Pull Requests with review requested:");
+        prs.forEach((pr, i) => {
+            console.log(`${i + 1}) #${pr.number} - ${pr.title}`);
+        });
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        rl.question(`\n👉 Choose a PR to review [1-${prs.length}]: `, (answer) => {
+            rl.close();
+            const index = parseInt(answer, 10);
+            if (!isNaN(index) && index >= 1 && index <= prs.length) {
+                resolve(index - 1); // Return array index, not PR number
+            }
+            else {
+                resolve(null);
+            }
+        });
+    });
+}
+// Ask user to approve or reject the review suggestion
+function askReviewApproval(suggestion) {
+    return new Promise((resolve) => {
+        console.log('\n💡 AI-suggested review:\n');
+        console.log(suggestion);
+        console.log('\n---');
+        console.log('1) ✅ Approve');
+        console.log('2) ❌ Reject');
+        console.log('3) ✍️ Edit');
+        console.log('4) Write your own review');
+        console.log('5) 🚪 Cancel');
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        rl.question(`\n👉 Choose an option [1-5]: `, (answer) => {
+            rl.close();
+            if (answer === '1') {
+                resolve('approve');
+            }
+            else if (answer === '2') {
+                resolve('reject');
+            }
+            else if (answer === '3') {
+                resolve('edit');
+            }
+            else if (answer === '4') {
+                resolve('custom');
+            }
+            else if (answer === '5') {
+                resolve('cancel');
+            }
+            else {
+                console.log('⚠️ Invalid selection. Defaulting to "approve".');
+                resolve('approve');
+            }
+        });
+    });
+}
+// Prompt for custom review input
+function promptCustomReview() {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        rl.question('\n📝 Enter your custom review:\n> ', (input) => {
+            rl.close();
+            resolve(input.trim());
+        });
+    });
+}
+export async function reviewPullRequestCmd(branch = 'main', showAll = false) {
+    try {
+        console.log("🔍 Fetching pull requests and diffs...");
+        const token = await ensureGitHubAuth();
+        const username = await getGitHubUsername(token);
+        const { owner, repo } = getRepoDetails();
+        console.log(`👤 Authenticated user: ${username}`);
+        console.log(`📦 GitHub repo: ${owner}/${repo}`);
+        console.log(`🔍 Filtering ${showAll ? "all" : "user-specific"} PRs for branch: ${branch}`);
+        const prsWithReviewRequested = await getPullRequestsForReview(token, owner, repo, username, branch, !showAll);
+        console.log(`🔍 Found ${prsWithReviewRequested.length} PR(s) requiring review.`);
+        if (prsWithReviewRequested.length === 0) {
+            console.log("⚠️ No PRs found with review requested.");
+            return;
+        }
+        const selectedIndex = await askUserToPickPR(prsWithReviewRequested.map(p => p.pr));
+        if (selectedIndex === null)
+            return;
+        const { pr, diff } = prsWithReviewRequested[selectedIndex];
+        let prDiff = diff;
+        if (!prDiff) {
+            console.log(`🔍 Fetching diff for PR #${pr.number}...`);
+            prDiff = await fetchPullRequestDiff(pr, token);
+        }
+        const result = await reviewModule.run({ content: prDiff });
+        const reviewSuggestion = result.content || 'No review suggestion generated.';
+        const reviewChoice = await askReviewApproval(reviewSuggestion);
+        let reviewEvent;
+        if (reviewChoice === 'approve') {
+            reviewEvent = 'APPROVE';
+            console.log(`✅ Review for PR #${pr.number} approved.`);
+            await submitReview(pr.number, reviewSuggestion, reviewEvent);
+        }
+        else if (reviewChoice === 'reject') {
+            reviewEvent = 'REQUEST_CHANGES';
+            console.log(`❌ Review for PR #${pr.number} rejected.`);
+            await submitReview(pr.number, reviewSuggestion, reviewEvent);
+        }
+        else if (reviewChoice === 'cancel') {
+            console.log(`🚪 Review process for PR #${pr.number} cancelled.`);
+            return; // Exit the function and cancel the review process
+        }
+        else {
+            reviewEvent = 'COMMENT';
+            const customReview = await promptCustomReview();
+            console.log(`💬 Custom review: ${customReview}`);
+            await submitReview(pr.number, customReview, reviewEvent);
+        }
+    }
+    catch (err) {
+        console.error("❌ Error reviewing PR:", err.message);
+    }
+}

package/dist/config.js

@@ -5,6 +5,7 @@ const defaultConfig = {
     model: 'llama3',
     language: 'ts',
     indexDir: INDEX_DIR, // Default index directory from constants
+    githubToken: '', // Add githubToken to default config
 };
 // Function to ensure the configuration directory exists
 function ensureConfigDir() {
@@ -57,6 +58,15 @@ export const Config = {
         writeConfig({ indexDir });
         console.log(`📁 Index directory set to: ${indexDir}`);
     },
+    // Get the GitHub token from the config
+    getGitHubToken() {
+        return readConfig().githubToken || null;
+    },
+    // Set the GitHub token in the config
+    setGitHubToken(token) {
+        writeConfig({ githubToken: token });
+        console.log("✅ GitHub token updated");
+    },
     // Show the current configuration
     show() {
         const cfg = readConfig();
@@ -64,5 +74,6 @@ export const Config = {
         console.log(`   Model     : ${cfg.model}`);
         console.log(`   Language  : ${cfg.language}`);
         console.log(`   Index dir : ${cfg.indexDir}`);
+        console.log(`   GitHub Token: ${cfg.githubToken ? '*****' : 'Not Set'}`);
     }
 };

package/dist/github/api.js

@@ -0,0 +1,43 @@
+export async function fetchOpenPullRequests(token, owner, repo) {
+    const url = `https://api.github.com/repos/${owner}/${repo}/pulls`;
+    const res = await fetch(url, {
+        headers: {
+            Authorization: `token ${token}`,
+            Accept: "application/vnd.github.v3+json",
+        },
+    });
+    if (!res.ok) {
+        throw new Error(`GitHub API error: ${res.status} ${res.statusText}`);
+    }
+    const prs = await res.json();
+    return prs.map((pr) => ({
+        number: pr.number,
+        title: pr.title,
+        diff_url: pr.diff_url,
+    }));
+}
+export async function fetchPullRequestDiff(pr, token) {
+    const res = await fetch(pr.diff_url, {
+        headers: {
+            Authorization: `token ${token}`,
+            Accept: "application/vnd.github.v3.diff",
+        },
+    });
+    if (!res.ok) {
+        throw new Error(`Error fetching PR diff: ${res.status} ${res.statusText}`);
+    }
+    return await res.text();
+}
+export async function getGitHubUsername(token) {
+    const res = await fetch('https://api.github.com/user', {
+        headers: {
+            Authorization: `token ${token}`,
+            Accept: "application/vnd.github.v3+json",
+        },
+    });
+    if (!res.ok) {
+        throw new Error(`Error fetching user info: ${res.status} ${res.statusText}`);
+    }
+    const user = await res.json();
+    return user.login; // GitHub username
+}

package/dist/github/auth.js

@@ -0,0 +1,15 @@
+import { Config } from '../config.js';
+import { promptForToken } from './token.js';
+export async function ensureGitHubAuth() {
+    // First check if the token exists in the config
+    let token = Config.getGitHubToken();
+    if (token) {
+        return token; // Token already exists in config, return it
+    }
+    // Token doesn't exist in config, prompt the user for it
+    console.log("🔐 GitHub token not found.");
+    token = await promptForToken();
+    // Save the token in the config
+    Config.setGitHubToken(token.trim());
+    return token.trim();
+}

package/dist/github/github.js

@@ -0,0 +1,71 @@
+import { ensureGitHubAuth } from './auth.js';
+import { getRepoDetails } from './repo.js';
+export async function fetchOpenPullRequests(token, owner, repo) {
+    const url = `https://api.github.com/repos/${owner}/${repo}/pulls?state=open&per_page=100`;
+    const res = await fetch(url, {
+        headers: {
+            Authorization: `token ${token}`,
+            Accept: 'application/vnd.github.v3+json',
+        },
+    });
+    if (!res.ok) {
+        throw new Error(`GitHub API error: ${res.status} ${res.statusText}`);
+    }
+    const prs = await res.json();
+    return prs.map((pr) => ({
+        number: pr.number,
+        title: pr.title,
+        url: pr.url,
+        diff_url: pr.diff_url,
+        draft: pr.draft,
+        merged_at: pr.merged_at,
+        base: pr.base,
+        requested_reviewers: pr.requested_reviewers,
+    }));
+}
+export async function getGitHubUsername(token) {
+    const res = await fetch('https://api.github.com/user', {
+        headers: {
+            Authorization: `token ${token}`,
+            Accept: "application/vnd.github.v3+json",
+        },
+    });
+    if (!res.ok) {
+        throw new Error(`Error fetching user info: ${res.status} ${res.statusText}`);
+    }
+    const user = await res.json();
+    return user.login; // GitHub username
+}
+export async function fetchPullRequestDiff(pr, token) {
+    const res = await fetch(pr.diff_url, {
+        headers: {
+            Authorization: `token ${token}`,
+            Accept: "application/vnd.github.v3.diff",
+        },
+    });
+    if (!res.ok) {
+        throw new Error(`Error fetching PR diff: ${res.status} ${res.statusText}`);
+    }
+    return await res.text();
+}
+export async function submitReview(prNumber, body, event = 'COMMENT') {
+    const token = await ensureGitHubAuth();
+    const { owner, repo } = getRepoDetails();
+    const url = `https://api.github.com/repos/${owner}/${repo}/pulls/${prNumber}/reviews`;
+    const res = await fetch(url, {
+        method: 'POST',
+        headers: {
+            Authorization: `token ${token}`,
+            Accept: 'application/vnd.github.v3+json',
+        },
+        body: JSON.stringify({
+            body,
+            event,
+        }),
+    });
+    if (!res.ok) {
+        const errorText = await res.text();
+        throw new Error(`Failed to submit review: ${res.status} ${res.statusText} - ${errorText}`);
+    }
+    console.log(`✅ Submitted ${event} review for PR #${prNumber}`);
+}

package/dist/github/githubAuthCheck.js

@@ -0,0 +1,17 @@
+import { ensureGitHubAuth } from './auth.js';
+import { getRepoDetails } from './repo.js';
+export async function validateGitHubTokenAgainstRepo() {
+    const token = await ensureGitHubAuth();
+    const { owner, repo } = getRepoDetails();
+    const response = await fetch(`https://api.github.com/repos/${owner}/${repo}`, {
+        headers: {
+            Authorization: `Bearer ${token}`,
+            'User-Agent': 'scai-cli',
+        },
+    });
+    if (!response.ok) {
+        const error = await response.json().catch(() => ({}));
+        throw new Error(`❌ Token is invalid or lacks access to ${owner}/${repo}. GitHub says: ${response.status} ${response.statusText}${error.message ? ` – ${error.message}` : ''}`);
+    }
+    return `✅ GitHub token is valid for ${owner}/${repo}`;
+}

package/dist/github/repo.js

@@ -0,0 +1,57 @@
+import path from 'path';
+import { execSync } from 'child_process';
+import { Config } from '../config.js';
+/**
+ * Executes a Git command inside the specified working directory.
+ */
+function runGitCommand(cmd, cwd) {
+    return execSync(cmd, { cwd, encoding: 'utf-8' }).trim();
+}
+/**
+ * Retrieves the owner and repo name from the Git remote URL inside the indexDir.
+ * This ensures we get the correct GitHub repo owner and name, regardless of current working directory.
+ */
+function getRepoOwnerAndNameFromGit(indexDir) {
+    try {
+        const originUrl = runGitCommand('git config --get remote.origin.url', indexDir);
+        console.log(`🔗 Git origin URL from '${indexDir}': ${originUrl}`);
+        const match = originUrl.match(/github\.com[:/](.+?)(?:\.git)?$/);
+        if (!match)
+            throw new Error("❌ Could not parse GitHub repo from origin URL.");
+        const [owner, repo] = match[1].split('/');
+        console.log(`✅ Parsed from Git: owner='${owner}', repo='${repo}'`);
+        return { owner, repo };
+    }
+    catch (error) {
+        console.warn(`⚠️ Failed to parse GitHub info from Git config in '${indexDir}': ${error instanceof Error ? error.message : error}`);
+        throw error;
+    }
+}
+/**
+ * Fallback: Extracts GitHub repo owner and name from the index directory path.
+ */
+function getRepoOwnerAndNameFromIndexDir(indexDir) {
+    const parts = path.resolve(indexDir).split(path.sep);
+    const repo = parts.pop();
+    const owner = parts.pop();
+    console.log(`📁 Parsed from indexDir: owner='${owner}', repo='${repo}'`);
+    return { owner, repo };
+}
+/**
+ * Get the GitHub repo details, always from the configured indexDir.
+ * Prefers Git config, falls back to parsing the path.
+ */
+export function getRepoDetails() {
+    const indexDir = Config.getIndexDir();
+    if (!indexDir) {
+        throw new Error("❌ indexDir is not configured.");
+    }
+    console.log(`📦 Resolving GitHub repo info from indexDir: ${indexDir}`);
+    try {
+        return getRepoOwnerAndNameFromGit(indexDir);
+    }
+    catch {
+        console.log("🔁 Falling back to extracting from indexDir path...");
+        return getRepoOwnerAndNameFromIndexDir(indexDir);
+    }
+}

package/dist/github/token.js

@@ -0,0 +1,14 @@
+// Utility function to prompt for GitHub token
+import readline from 'readline';
+export function promptForToken() {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        rl.question('Paste your GitHub Personal Access Token (scopes: `repo`): ', (token) => {
+            rl.close();
+            resolve(token);
+        });
+    });
+}

package/dist/github/types.js

@@ -0,0 +1 @@
+"use strict";

package/dist/index.js

@@ -22,6 +22,9 @@ import { runAskCommand } from './commands/AskCmd.js';
 import { runBackupCommand } from './commands/BackupCmd.js';
 import { runMigrateCommand } from "./commands/MigrateCmd.js";
 import { runInspectCommand } from "./commands/InspectCmd.js";
+import { reviewPullRequestCmd } from "./commands/ReviewCmd.js";
+import { promptForToken } from "./github/token.js";
+import { validateGitHubTokenAgainstRepo } from "./github/githubAuthCheck.js";
 // 🎛️ CLI Setup
 const cmd = new Command('scai')
     .version(version)
@@ -47,8 +50,59 @@ cmd
 defineSuggCommand(cmd);
 // 🔧 Group: Git-related commands
 const git = cmd.command('git').description('Git utilities');
+git
+    .command('review')
+    .description('Review an open pull request using AI')
+    .option('-a, --all', 'Show all PRs requiring a review (not just for the current user)', false) // New option for showing all PRs
+    .action(async (cmd) => {
+    const showAll = cmd.all; // Access the flag passed via command line
+    await reviewPullRequestCmd('main', showAll); // Pass the flag to the review function
+});
 // Register `sugg` under `git` group
 defineSuggCommand(git);
+// Add auth-related commands
+const auth = cmd.command('auth').description('GitHub authentication commands');
+auth
+    .command('check')
+    .description('Check if GitHub authentication is set up and valid')
+    .action(async () => {
+    try {
+        const token = Config.getGitHubToken();
+        if (!token) {
+            console.log('❌ GitHub authentication not found. Please set your token.');
+            return;
+        }
+        // Call the new check
+        const result = await validateGitHubTokenAgainstRepo();
+        console.log(result);
+    }
+    catch (err) {
+        console.error(typeof err === 'string' ? err : err.message);
+    }
+});
+auth
+    .command('reset')
+    .description('Reset GitHub authentication credentials')
+    .action(() => {
+    Config.setGitHubToken(''); // Clears the GitHub token from the config
+    console.log('🔄 GitHub authentication has been reset.');
+    // Check if the token is successfully removed
+    const token = Config.getGitHubToken();
+    if (!token) {
+        console.log('✅ Token successfully removed from configuration.');
+    }
+    else {
+        console.log('❌ Token still exists in the configuration.');
+    }
+});
+auth
+    .command('set')
+    .description('Set your GitHub Personal Access Token')
+    .action(async () => {
+    const token = await promptForToken();
+    Config.setGitHubToken(token.trim());
+    console.log('🔑 GitHub token set successfully.');
+});
 // 🛠️ Group: `gen` commands for content generation
 const gen = cmd.command('gen').description('Generate code-related output');
 gen

package/dist/pipeline/modules/reviewModule.js

@@ -0,0 +1,21 @@
+import { generate } from '../../lib/generate.js';
+import { Config } from '../../config.js';
+export const reviewModule = {
+    name: 'review',
+    description: 'Reviews code diff or PR content and provides feedback',
+    async run({ content, filepath }) {
+        const model = Config.getModel();
+        const prompt = `
+You are a senior software engineer reviewing a pull request. 
+Give clear, constructive feedback based on the code changes below.
+
+Changes:
+${content}
+`.trim();
+        const response = await generate({ content: prompt, filepath }, model);
+        return {
+            content: response.content,
+            filepath,
+        };
+    }
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scai",
-  "version": "0.1.50",
+  "version": "0.1.51",
   "type": "module",
   "bin": {
     "scai": "./dist/index.js"