scai 0.1.50 → 0.1.52

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  
 
 ---
 
@@ -53,6 +52,80 @@ scai runs entirely on your machine and doesn't require cloud APIs or API keys. T
    scai init
    ```
 
+## ✨ AI Code Review, Powered by Your Terminal
+
+No more struggling to write pull request descriptions by hand. `scai git review` automatically generates a rich summary of your changes, complete with context, suggestions, and rationale.
+
+> ⚠️ These features are in **beta** — feedback welcome!
+
+## 🙌 Feedback
+
+Questions, ideas, or bugs?  
+Ping [@ticcr](https://bsky.app/profile/ticcr.xyz) on Bluesky — I'd love to hear your thoughts!
+
+
+---
+
+### 🔑 Setting Up Authentication (Required)
+
+To interact with GitHub and create pull requests, `scai` needs a personal access token with **repo** permissions.
+
+1. **Create your GitHub Access Token**
+   Follow this link to generate a token: [https://github.com/settings/tokens?type=beta](https://github.com/settings/tokens?type=beta)
+
+   Make sure you enable at least:
+
+   * `repo` (Full control of private repositories)
+   * `workflow` (If you want PRs to trigger CI)
+
+2. **Set the token in scai:**
+
+   ```bash
+   scai auth set
+   ```
+
+   This stores your token locally in a secure config file. You can inspect the setup at any time:
+
+   ```bash
+   scai auth check
+   ```
+
+3. **Set the index dir:**
+
+   ```bash
+   scai set index-dir <repo path>
+   ```
+
+   This is the repo from which scai will look up pull requests that can be reviewed. 
+
+---
+
+### 🧠 How to Use `scai git review`
+
+```bash
+scai git review
+```
+
+This will show you pull requests assigned to you for review:
+
+* Understand the diffs using a local model
+* Generate a structured pull request:
+
+  * ✅ Title
+  * ✅ Summary of changes
+  * ✅ Explanation of why the changes matter
+  * ✅ Optional changelog bullets
+
+You’ll be shown a preview and asked to confirm before pushing or opening a PR.
+
+#### Flags
+
+You can override behavior like this:
+
+```bash
+scai git review -a
+```
+This will show you all pull requests that have not yet been reviewed. 
 
 ## ⚒️ Usage Overview
 
@@ -206,7 +279,7 @@ You won't gain much value from the index unless you scope it to one repository.
 
 ## 🔄 Breaking Change in v0.1.47
 
-> 🛠️ As of `v0.1.47`, the internal database schema has changed.
+> 🛠️ As of `v0.1.47`, the internal database schema has changed, and may well change in the future.
 
 🚨 **OBS**: The **Migrate** command is for **internal use only**. Do **not** run it unless explicitly instructed, as it may delete existing data or corrupt your local database.
 
@@ -259,6 +332,10 @@ You may **not**:
 * ❌ Resell as a product or service
 * ❌ Claim ownership of the tool
 
-See [LICENSE](./LICENSE) for full terms.
+### 📄 License
+
+Free for personal and internal company use only.
+Commercial use (resale, SaaS, inclusion in paid tools) is prohibited.
+Contact me for commercial licensing.
 
 ```

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

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+//!/usr/bin/env node
 import { Command } from "commander";
 import path from "path";
 import { Config } from './config.js';
@@ -22,19 +22,14 @@ 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)
     .option('--model <model>', 'Set the model to use (e.g., codellama:34b)')
     .option('--lang <lang>', 'Set the target language (ts, java, rust)');
-function defineSuggCommand(cmd) {
-    cmd
-        .command('sugg')
-        .description('Suggest a commit message from staged changes')
-        .option('-c, --commit', 'Automatically commit with suggested message')
-        .option('-l, --changelog', 'Generate and optionally stage a changelog entry')
-        .action((options) => suggestCommitMessage(options));
-}
 // 🔧 Main command group
 cmd
     .command('init')
@@ -43,12 +38,58 @@ cmd
     await bootstrap();
     console.log('✅ Model initialization completed!');
 });
-// Register top-level `sugg` command
-defineSuggCommand(cmd);
 // 🔧 Group: Git-related commands
 const git = cmd.command('git').description('Git utilities');
-// Register `sugg` under `git` group
-defineSuggCommand(git);
+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)
+    .action(async (cmd) => {
+    const showAll = cmd.all;
+    await reviewPullRequestCmd('main', showAll);
+});
+git
+    .command('sugg')
+    .description('Suggest a commit message from staged changes')
+    .option('-c, --commit', 'Automatically commit with suggested message')
+    .option('-l, --changelog', 'Generate and optionally stage a changelog entry')
+    .action((options) => suggestCommitMessage(options));
+// 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;
+        }
+        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('');
+    console.log('🔄 GitHub authentication has been reset.');
+    const token = Config.getGitHubToken();
+    console.log(token ? '❌ Token still exists in the configuration.' : '✅ Token successfully removed.');
+});
+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
@@ -93,14 +134,12 @@ set
     Config.setIndexDir(path.resolve(dir));
     Config.show();
 });
-// 🧪 Diagnostics and info
 cmd
     .command('config')
     .description('Show the currently active model and language settings')
     .action(() => {
     Config.show();
 });
-// 🔍 Indexing
 cmd
     .command('index [targetDir]')
     .description('Index supported files in the given directory (or current folder if none)')
@@ -112,24 +151,22 @@ cmd
     .command('backup')
     .description('Backup the current .scai folder')
     .action(runBackupCommand);
-// 🧠 Query and assistant
 cmd
     .command('find <query>')
     .description('Search indexed files by keyword')
     .action(runFindCommand);
 cmd
-    .command('ask [question...]') // <- the ... makes it variadic
+    .command('ask [question...]')
     .description('Ask a question based on indexed files')
     .action((questionParts) => {
     const fullQuery = questionParts?.join(' ');
     runAskCommand(fullQuery);
 });
-// 🛠️ Background tasks and maintenance
 cmd
     .command('daemon')
     .description('Run background summarization of indexed files')
     .action(async () => {
-    await startDaemon(); // ignore the return value
+    await startDaemon();
 });
 cmd
     .command('stop-daemon')
@@ -150,9 +187,10 @@ cmd
     .command('reset-db')
     .description('Delete and reset the SQLite database')
     .action(() => resetDatabase());
-// 🧬 Fallback: Pipeline mode
 cmd
-    .arguments('<file>')
+    .command('pipe')
+    .description('Run a module pipeline on a given file')
+    .argument('<file>', 'Target file')
     .option('-m, --modules <modules>', 'Comma-separated list of modules to run (e.g., comments,cleanup,summary)')
     .action((file, options) => {
     if (!options.modules) {
@@ -161,7 +199,6 @@ cmd
     }
     runModulePipelineFromCLI(file, options);
 });
-// Add explanation about alpha features directly in the help menu
 cmd.addHelpText('after', `
 🚨 Alpha Features:
   - The "index", "daemon", "stop-daemon", "reset-db" commands are considered alpha features.
@@ -169,9 +206,7 @@ cmd.addHelpText('after', `
 
 💡 Use with caution and expect possible changes or instability.
 `);
-// ✅ Parse CLI args
 cmd.parse(process.argv);
-// 🔁 Apply global options post-parse
 const opts = cmd.opts();
 if (opts.model)
     Config.setModel(opts.model);

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.52",
   "type": "module",
   "bin": {
     "scai": "./dist/index.js"
@@ -16,9 +16,19 @@
     "ai",
     "refactor",
     "devtools",
+    "developer-tools",
     "local",
+    "offline",
     "typescript",
-    "llm"
+    "llm",
+    "code-review",
+    "commit-message",
+    "git",
+    "changelog",
+    "productivity",
+    "scai",
+    "review",
+    "commit"
   ],
   "scripts": {
     "build": "rm -rfd dist && tsc && git add .",
@@ -46,4 +56,4 @@
     "dist/",
     "README.md"
   ]
-}
+}