scai 0.1.82 → 0.1.84

package/dist/CHANGELOG.md

@@ -0,0 +1,102 @@
+## 2025-06-23
+
+The new markdown bullet-point entry for CHANGELOG.md includes the following updates:
+
+* Added support for generating changelog entries based on Git diffs using the `changelog` command.
+* Updated the summary of the code file directly to the terminal using the `summ` command.
+* Refactored the code to use the new `handleChangelogUpdate()` function instead of the old `updateReadmeIfNeeded()` function for generating changelogs.
+
+## 2025-06-24
+
+### Changelog Update (Version 0.1.16)
+
+* Update to version 0.1.16 with changes from `package.json`.
+* Add support for running modules using the `module` command.
+* Add support for generating tests using the `tests` module.
+* Add support for suggesting a commit message using the `suggest` module.
+* Add support for updating the changelog using the `changelog` module.
+
+
+## 2025-06-29
+Type handling with the module pipeline
+┌────────────────────────────────────────────────────────────────┐
+│  1. Command Layer (CLI)                                        │
+│  - User interaction                                            │
+│  - Handles input/output                                        │
+│                                                                │
+│  🡆 Uses:                                                      │
+│     - Input:  PromptInput                                      │
+│     - Output: PromptOutput (reads summary/suggestions)         │
+└────────────┬───────────────────────────────────────────────────┘
+             │
+             ▼
+┌────────────────────────────────────────────────────────────────┐
+│  2. PromptModule Layer                                         │
+│  - Domain-specific logic                                       │
+│  - Calls `generate()`                                          │
+│  - Parses model output into usable fields                      │
+│                                                                │
+│  🡆 Type: PromptModule                                         │
+│     - run(input: PromptInput) => Promise<PromptOutput>         │
+│                                                                │
+│  🡆 Uses:                                                      │
+│     - Receives: PromptInput                                    │
+│     - Calls: generate(PromptInput, model): Promise<PromptOutput>│
+│     - Parses output.content → summary/suggestions fields       │
+└────────────┬───────────────────────────────────────────────────┘
+             │
+             ▼
+┌────────────────────────────────────────────────────────────────┐
+│  3. generate() Function                                        │
+│  - Sends prompt to model                                       │
+│  - Returns raw model text in `.content`                        │
+│                                                                │
+│  🡆 Signature:                                                  │
+│     generate(input: PromptInput, model: string)                │
+│       => Promise<PromptOutput>                                 │
+│                                                                │
+│  🡆 Output fields:                                             │
+│     - content: string (LLM output text)                        │
+│     - filepath?: string (optional passthrough)                │
+└────────────────────────────────────────────────────────────────┘
+
+
+
+## 2025-06-30
+
+* Added context generation via summaries in sqlite3 db with FTS5
+* Improved the `dbstats.sh` script to include more accurate row counts and improved formatting for better readability. (#20)
+* Added an `IGNORED_FOLDER_GLOBS` constant in `src/config/IgnoredPaths.ts` to allow for ignoring folders and file globs during indexing and scanning. (#17)
+* Fixed a bug in the `searchFiles` function of `src/db/fileIndex.ts` that prevented search results from being returned correctly. (#25)
+* Updated the `runModulePipeline` function in `src/pipeline/runModulePipeline.ts` to allow for returning more accurate output and ensure consistent return types. (#27)
+
+## 2025-07-01
+
+### Version 0.1.20 (2023-04-01)
+* Added support for querying file summaries and a local model using the `scai ask` command. The command will first search for matching files and pass their summaries to the model for context-based synthesis, if any are found. If no summaries are found, it will instead query the model for context without them.
+
+
+## 2025-07-12
+
+* • Fixes to improve code quality and maintainability.
+* • Enhances model initialization for better performance.
+* • Adds support for generating changelogs based on Git diff.
+* • Improves the handling of ignored files to reduce noise in the model.
+* • Updates the `changelog` command to generate a meaningful summary.
+* • Enhances the `sugg` command to provide more accurate suggestions.
+* • Fixes issues with refactoring code to improve readability.
+
+## 2025-07-24
+
+* Added token and owner/repo parameters to `getPullRequestsForReview` function
+* Updated `askUserToPickPR` function to accept a list of PR objects
+* Removed unnecessary code from `reviewPullRequestCmd`
+* Added `cancel` option to `askReviewApproval` function
+
+## 2025-08-10
+
+• Removed versioned dist folder 
+• Update .gitignore to ignore Node and build artifacts, editor/IDE files, and project-specific ignores.
+• Added scripts for building cli, server, and dashboard
+• Restructure the workspace into 3 modules, cli, dashboard, server
+• Improved `askChangelogApproval` to support editing and skipping of changelog entries

package/dist/commands/ChangeLogUpdateCmd.js

@@ -5,16 +5,10 @@ import path from 'path';
 import { runModulePipeline } from '../pipeline/runModulePipeline.js';
 import { changelogModule } from '../pipeline/modules/changeLogModule.js';
 import { askChangelogApproval } from '../utils/changeLogPrompt.js';
+import { openTextEditor } from '../utils/editor.js';
 export async function handleStandaloneChangelogUpdate() {
-    let diff = execSync("git diff", { encoding: "utf-8", stdio: "pipe" }).trim();
-    if (!diff) {
-        diff = execSync("git diff --cached", { encoding: "utf-8", stdio: "pipe" }).trim();
-    }
-    if (!diff) {
-        console.log('⚠️ No changes detected for changelog.');
-        return;
-    }
-    let entry = await generateChangelogEntry(diff);
+    // Don't bother with diffs at all here
+    let entry = await generateChangelogEntry();
     if (!entry) {
         console.log('⚠️ No significant changes found.');
         return;
@@ -28,7 +22,7 @@ export async function handleStandaloneChangelogUpdate() {
         }
         else if (userChoice === 'redo') {
             console.log('🔁 Regenerating changelog...');
-            entry = await generateChangelogEntry(diff);
+            entry = await generateChangelogEntry();
             if (!entry) {
                 console.log('⚠️ Could not regenerate entry. Exiting.');
                 break;
@@ -40,26 +34,26 @@ export async function handleStandaloneChangelogUpdate() {
         }
     }
 }
-export async function generateChangelogEntry(diff) {
+export async function generateChangelogEntry(currentCommitMsg) {
     try {
-        // If no diff is provided, fetch the current diff from git silently
-        if (!diff) {
-            diff = execSync("git diff", { encoding: "utf-8", stdio: 'pipe' }).trim();
-            // If no unstaged changes, fall back to staged changes
-            if (!diff) {
-                diff = execSync("git diff --cached", { encoding: "utf-8", stdio: 'pipe' }).trim();
-            }
+        const lastTag = getLastGitTag();
+        if (!lastTag) {
+            console.log("⚠️ No previous git tag found. Using all commits.");
         }
-        if (!diff) {
-            // No changes found, auto cancel by returning null
-            console.log('⚠️ No changes detected for the changelog.');
+        let commits = lastTag
+            ? getCommitsSinceTag(lastTag)
+            : execSync('git log --pretty=format:%s', { encoding: 'utf-8' }).trim();
+        if (currentCommitMsg) {
+            commits = commits ? `${commits}\n${currentCommitMsg}` : currentCommitMsg;
+        }
+        console.log('Number of commits:', commits.split('\n').length);
+        if (!commits) {
+            console.log("⚠️ No commits found since last release.");
             return null;
         }
-        // Generate the changelog entry using the diff silently
-        const result = await runModulePipeline([changelogModule], { content: diff });
+        const result = await runModulePipeline([changelogModule], { content: commits });
         const output = result?.summary?.trim();
         if (!output || output === 'NO UPDATE') {
-            // Auto-cancel if no update
             console.log('⚠️ No significant changes detected for changelog.');
             return null;
         }
@@ -70,6 +64,18 @@ export async function generateChangelogEntry(diff) {
         return null;
     }
 }
+function getLastGitTag() {
+    try {
+        return execSync('git describe --tags --abbrev=0', { encoding: 'utf-8' }).trim();
+    }
+    catch {
+        return null; // no tags found
+    }
+}
+function getCommitsSinceTag(tag) {
+    // Get commit messages in a simple format, e.g. only commit messages
+    return execSync(`git log ${tag}..HEAD --pretty=format:%s`, { encoding: 'utf-8' }).trim();
+}
 export async function updateChangelogFile(entry) {
     const root = execSync("git rev-parse --show-toplevel", { encoding: "utf-8" }).trim();
     const changelogPath = path.join(root, "CHANGELOG.md");
@@ -85,3 +91,38 @@ export async function updateChangelogFile(entry) {
     await fs.writeFile(changelogPath, existing + newEntry, 'utf-8');
     return changelogPath;
 }
+export async function handleChangelogWithCommitMessage(commitMsg) {
+    let entryFinalized = false;
+    let changelogEntry = await generateChangelogEntry(commitMsg);
+    if (!changelogEntry) {
+        console.log("ℹ️ No changelog entry generated.");
+        return;
+    }
+    while (!entryFinalized) {
+        const userChoice = await askChangelogApproval(changelogEntry);
+        if (userChoice === 'yes') {
+            const changelogPath = await updateChangelogFile(changelogEntry);
+            execSync(`git add "${changelogPath}"`);
+            console.log("✅ CHANGELOG.md staged.");
+            entryFinalized = true;
+        }
+        else if (userChoice === 'redo') {
+            console.log("🔁 Regenerating changelog entry...");
+            changelogEntry = await generateChangelogEntry(commitMsg);
+            if (!changelogEntry) {
+                console.log('⚠️ Could not regenerate entry. Exiting.');
+                break;
+            }
+        }
+        else if (userChoice === 'edit') {
+            changelogEntry = await openTextEditor(changelogEntry, 'scai-changelog.txt');
+            if (!changelogEntry) {
+                console.log('⚠️ No changes made to changelog. Returning to prompt.');
+            }
+        }
+        else {
+            console.log("❌ Skipped changelog update.");
+            entryFinalized = true;
+        }
+    }
+}

package/dist/commands/CommitSuggesterCmd.js

@@ -2,23 +2,28 @@
 import { execSync } from 'child_process';
 import readline from 'readline';
 import { commitSuggesterModule } from '../pipeline/modules/commitSuggesterModule.js';
-import { generateChangelogEntry, updateChangelogFile } from './ChangeLogUpdateCmd.js';
-import { askChangelogApproval } from '../utils/changeLogPrompt.js';
+import { handleChangelogWithCommitMessage } from './ChangeLogUpdateCmd.js';
+import os from 'os';
+import fs from 'fs';
+import path from 'path';
+import { spawnSync } from 'child_process';
+import chalk from 'chalk';
 function askUserToChoose(suggestions) {
     return new Promise((resolve) => {
         console.log('\n💡 AI-suggested commit messages:\n');
         suggestions.forEach((msg, i) => {
-            console.log(`${i + 1}) ${msg}`);
+            console.log(`${i + 1}) ${chalk.hex('#FFA500')(`\`${msg}\``)}`);
         });
         console.log('\n---');
         console.log(`${suggestions.length + 1}) 🔁 Regenerate suggestions`);
         console.log(`${suggestions.length + 2}) ✍️  Write your own commit message`);
-        console.log(`${suggestions.length + 3}) ❌ Cancel`);
+        console.log(`${suggestions.length + 3}) 🖋️ Edit a suggested commit message`);
+        console.log(`${suggestions.length + 4}) ❌ Cancel`);
         const rl = readline.createInterface({
             input: process.stdin,
             output: process.stdout,
         });
-        rl.question(`\n👉 Choose a commit message [1-${suggestions.length + 3}]: `, (answer) => {
+        rl.question(`\n👉 Choose a commit message [1-${suggestions.length + 4}]: `, (answer) => {
             rl.close();
             const choice = parseInt(answer, 10);
             if (choice === suggestions.length + 1) {
@@ -28,6 +33,9 @@ function askUserToChoose(suggestions) {
                 resolve('custom');
             }
             else if (choice === suggestions.length + 3) {
+                resolve('edit');
+            }
+            else if (choice === suggestions.length + 4) {
                 resolve('cancel');
             }
             else if (!isNaN(choice) && choice >= 1 && choice <= suggestions.length) {
@@ -40,6 +48,46 @@ function askUserToChoose(suggestions) {
         });
     });
 }
+async function promptEditCommitMessage(suggestedMessage) {
+    const tmpFilePath = path.join(os.tmpdir(), 'scai-commit-msg.txt');
+    fs.writeFileSync(tmpFilePath, `# Edit your commit message below.\n# Lines starting with '#' will be ignored.\n\n${suggestedMessage}`);
+    const editor = process.env.EDITOR || (process.platform === 'win32' ? 'notepad' : 'vi');
+    spawnSync(editor, [tmpFilePath], { stdio: 'inherit' });
+    const editedContent = fs.readFileSync(tmpFilePath, 'utf-8');
+    return editedContent
+        .split('\n')
+        .filter(line => !line.trim().startsWith('#'))
+        .join('\n')
+        .trim() || suggestedMessage;
+}
+function askWhichSuggestionToEdit(suggestions) {
+    return new Promise((resolve) => {
+        console.log('\n🖋️ Select a commit message to edit:\n');
+        suggestions.forEach((msg, i) => {
+            console.log(`${i + 1}) ${chalk.hex('#FFA500')(`\`${msg}\``)}`);
+        });
+        console.log(`${suggestions.length + 1}) ❌ Cancel`);
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        const editPrompt = chalk.magenta(`\n👉 Choose a commit message to edit [1-${suggestions.length + 1}]: `);
+        rl.question(editPrompt, (answer) => {
+            rl.close();
+            const choice = parseInt(answer, 10);
+            if (!isNaN(choice) && choice >= 1 && choice <= suggestions.length) {
+                resolve(choice - 1);
+            }
+            else if (choice === suggestions.length + 1) {
+                resolve('cancel');
+            }
+            else {
+                console.log('⚠️ Invalid selection.');
+                resolve('cancel');
+            }
+        });
+    });
+}
 function promptCustomMessage() {
     return new Promise((resolve) => {
         const rl = readline.createInterface({
@@ -53,42 +101,15 @@ function promptCustomMessage() {
     });
 }
 export async function suggestCommitMessage(options) {
-    // Ensure git diff does not print to console
     try {
-        let diff = execSync("git diff", { encoding: "utf-8", stdio: "pipe" }).trim();
+        let diff = execSync("git diff --cached", { encoding: "utf-8", stdio: "pipe" }).trim();
         if (!diff) {
-            diff = execSync("git diff --cached", { encoding: "utf-8", stdio: "pipe" }).trim();
+            diff = execSync("git diff", { encoding: "utf-8", stdio: "pipe" }).trim();
         }
         if (!diff) {
-            console.log('⚠️  No staged changes to suggest a message for.');
+            console.log('⚠️ No staged changes to suggest a message for.');
             return;
         }
-        // Handle changelog generation if the flag is provided
-        if (options.changelog) {
-            let entryFinalized = false;
-            while (!entryFinalized) {
-                const changelogEntry = await generateChangelogEntry(diff);
-                if (!changelogEntry) {
-                    console.log("ℹ️ No changelog entry generated.");
-                    break;
-                }
-                const userChoice = await askChangelogApproval(changelogEntry);
-                if (userChoice === 'yes') {
-                    const changelogPath = await updateChangelogFile(changelogEntry);
-                    execSync(`git add "${changelogPath}"`);
-                    console.log("✅ CHANGELOG.md staged.");
-                    entryFinalized = true;
-                }
-                else if (userChoice === 'redo') {
-                    console.log("🔁 Regenerating changelog entry...");
-                    continue; // Loop again and regenerate
-                }
-                else {
-                    console.log("❌ Skipped changelog update.");
-                    entryFinalized = true;
-                }
-            }
-        }
         // Continue with commit suggestions
         const response = await commitSuggesterModule.run({ content: diff });
         const suggestions = response.suggestions || [];
@@ -108,6 +129,17 @@ export async function suggestCommitMessage(options) {
             if (choice === 'custom') {
                 message = await promptCustomMessage();
             }
+            else if (choice === 'edit') {
+                // Ask which suggestion to edit using a dedicated prompt
+                const editChoice = await askWhichSuggestionToEdit(suggestions);
+                if (typeof editChoice === 'number') {
+                    message = await promptEditCommitMessage(suggestions[editChoice]);
+                }
+                else {
+                    console.log('⚠️ Edit cancelled, returning to main menu.');
+                    continue;
+                }
+            }
             else if (choice === 'cancel') {
                 console.log('❌ Commit cancelled.');
                 return;
@@ -117,6 +149,10 @@ export async function suggestCommitMessage(options) {
             }
         }
         console.log(`\n✅ Selected commit message:\n${message}\n`);
+        // If changelog option is enabled, generate changelog including the selected commit message
+        if (options.changelog) {
+            await handleChangelogWithCommitMessage(message);
+        }
         const staged = execSync("git diff --cached", { encoding: "utf-8" }).trim();
         if (!staged) {
             console.log("⚠️ No files are currently staged for commit.");

package/dist/commands/RefactorCmd.js

@@ -2,16 +2,13 @@ import fs from 'fs/promises';
 import path from 'path';
 import { runModulePipeline } from '../pipeline/runModulePipeline.js';
 import { addCommentsModule } from '../pipeline/modules/commentModule.js';
-import { cleanupModule } from '../pipeline/modules/cleanupModule.js';
+import { normalizePath } from '../utils/normalizePath.js';
 export async function handleRefactor(filepath, options = {}) {
     try {
-        // Normalize path: add ./ prefix if no directory specified
-        if (!filepath.startsWith('./') && !filepath.startsWith('/') && !filepath.includes('\\')) {
-            filepath = `./${filepath}`;
-        }
+        // Normalize and resolve filepath (includes expanding ~ and consistent slashes)
+        filepath = normalizePath(filepath);
         const { dir, name, ext } = path.parse(filepath);
         const refactoredPath = path.join(dir, `${name}.refactored${ext}`);
-        // --apply flag: use existing refactored file and overwrite original
         if (options.apply) {
             try {
                 const refactoredCode = await fs.readFile(refactoredPath, 'utf-8');
@@ -24,13 +21,10 @@ export async function handleRefactor(filepath, options = {}) {
             }
             return;
         }
-        // Read source code
         const content = await fs.readFile(filepath, 'utf-8');
-        // Run through pipeline modules
-        const response = await runModulePipeline([addCommentsModule, cleanupModule], { content });
+        const response = await runModulePipeline([addCommentsModule], { content });
         if (!response.content.trim())
             throw new Error('⚠️ Model returned empty result');
-        // Save refactored output
         await fs.writeFile(refactoredPath, response.content, 'utf-8');
         console.log(`✅ Refactored code saved to: ${refactoredPath}`);
         console.log(`ℹ️ Run again with '--apply' to overwrite the original.`);

package/dist/commands/ReviewCmd.js

@@ -164,24 +164,6 @@ function askReviewApproval() {
         });
     });
 }
-function askFinalReviewApproval() {
-    return new Promise((resolve) => {
-        console.log('\n---');
-        console.log('1) ✅ Approve');
-        console.log('2) ❌ Request Changes');
-        console.log('3) 🚫 Cancel');
-        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-        rl.question(`\n👉 Choose an option [1-3]: `, (answer) => {
-            rl.close();
-            if (answer === '1')
-                resolve('approve');
-            else if (answer === '2')
-                resolve('request-changes');
-            else
-                resolve('cancel');
-        });
-    });
-}
 // Prompt for custom review
 function promptCustomReview() {
     return new Promise((resolve) => {
@@ -212,23 +194,20 @@ function chunkDiff(diff, review_id) {
         const fullChunk = 'diff --git ' + chunk;
         const filePathMatch = fullChunk.match(/^diff --git a\/(.+?) b\//);
         const filePath = filePathMatch ? filePathMatch[1] : 'unknown';
-        // Now we extract hunks and lines as per the DiffHunk type
         const hunks = [];
         let currentHunk = null;
-        // Split chunk into lines
+        // This counts diff lines for *this file only* (context/+/- lines after first @@)
+        let positionCounter = 0;
         const lines = fullChunk.split('\n');
         lines.forEach(line => {
-            const hunkHeaderMatch = line.match(/^@@ -(\d+),(\d+) \+(\d+),(\d+) @@/);
+            const hunkHeaderMatch = line.match(/^@@ -(\d+),?(\d*) \+(\d+),?(\d*) @@/);
             if (hunkHeaderMatch) {
-                // When we encounter a new hunk, process the previous one (if it exists) and start a new one
-                if (currentHunk) {
+                if (currentHunk)
                     hunks.push(currentHunk);
-                }
-                // Parse the hunk header
                 const oldStart = parseInt(hunkHeaderMatch[1], 10);
                 const newStart = parseInt(hunkHeaderMatch[3], 10);
-                const oldLines = parseInt(hunkHeaderMatch[2], 10);
-                const newLines = parseInt(hunkHeaderMatch[4], 10);
+                const oldLines = parseInt(hunkHeaderMatch[2] || '0', 10);
+                const newLines = parseInt(hunkHeaderMatch[4] || '0', 10);
                 currentHunk = {
                     oldStart,
                     newStart,
@@ -236,33 +215,33 @@ function chunkDiff(diff, review_id) {
                     newLines,
                     lines: [],
                 };
+                return; // don’t count @@ header line in positionCounter
             }
-            else if (currentHunk) {
-                // Process the lines inside the hunk
+            if (currentHunk) {
+                // Each line after @@ counts towards the diff position
+                positionCounter++;
                 let lineType = 'context';
                 if (line.startsWith('+'))
                     lineType = 'add';
                 if (line.startsWith('-'))
                     lineType = 'del';
-                // Create the DiffLine object
                 currentHunk.lines.push({
                     line,
                     type: lineType,
                     lineNumberOld: lineType === 'del' ? currentHunk.oldStart++ : undefined,
                     lineNumberNew: lineType === 'add' ? currentHunk.newStart++ : undefined,
-                    review_id, // Assign the review_id here
+                    position: positionCounter, // <-- key for GitHub inline API
+                    review_id,
                 });
             }
         });
-        // Push the last hunk (if any)
-        if (currentHunk) {
+        if (currentHunk)
             hunks.push(currentHunk);
-        }
         return {
             filePath,
             content: fullChunk,
-            hunks, // Return hunks, which now contain DiffLine objects with line numbers and review_id
-            review_id, // Assign the review_id here for each chunk
+            hunks,
+            review_id,
         };
     });
 }
@@ -419,48 +398,36 @@ export async function reviewPullRequestCmd(branch = 'main', showAll = false) {
             for (let i = 0; i < chunks.length; i++) {
                 const chunk = chunks[i];
                 const { choice, summary } = await reviewChunk(chunk, i, chunks.length);
-                if (choice === 'approve') {
-                    reviewComments.push({
-                        path: chunk.filePath,
-                        body: summary,
-                        line: chunk.hunks[0]?.newStart || 1,
-                        side: 'RIGHT',
-                    });
-                    console.log(`💬 Posted AI review for chunk ${i + 1}`);
-                }
-                else if (choice === 'reject') {
-                    allApproved = false;
-                    reviewComments.push({
-                        path: chunk.filePath,
-                        body: summary,
-                        line: chunk.hunks[0]?.newStart || 1,
-                        side: 'RIGHT',
-                    });
+                if (choice === 'cancel' || choice === 'skip') {
+                    console.log(chalk.gray(`⏭️ Skipped chunk ${i + 1}`));
+                    continue;
                 }
-                else if (choice === 'custom') {
-                    const customReview = await promptCustomReview();
-                    reviewComments.push({
-                        path: chunk.filePath,
-                        body: customReview,
-                        line: chunk.hunks[0]?.newStart || 1,
-                        side: 'RIGHT',
-                    });
+                // Find the first line in the chunk with a valid position (usually the first 'add' or 'context' line)
+                const firstLineWithPosition = chunk.hunks
+                    .flatMap(hunk => hunk.lines)
+                    .find(line => line.position !== undefined);
+                if (!firstLineWithPosition) {
+                    console.warn(`⚠️ Could not find valid position for inline comment in chunk ${i + 1}. Skipping comment.`);
+                    continue;
                 }
-                else if (choice === 'cancel' || choice === 'skip') {
-                    console.log(chalk.gray(`⏭️ Skipped chunk ${i + 1}`));
+                let commentBody = summary;
+                if (choice === 'custom') {
+                    commentBody = await promptCustomReview();
                 }
-                else if (typeof choice === 'string') {
-                    reviewComments.push({
-                        path: chunk.filePath,
-                        body: choice,
-                        line: chunk.hunks[0]?.newStart || 1,
-                        side: 'RIGHT',
-                    });
+                else if (typeof choice === 'string' && !['approve', 'reject', 'custom'].includes(choice)) {
+                    commentBody = choice;
                 }
+                reviewComments.push({
+                    path: chunk.filePath,
+                    body: commentBody,
+                    position: firstLineWithPosition.position,
+                });
+                if (choice === 'reject')
+                    allApproved = false;
             }
             console.log(chalk.blueBright('\n📝 Review Comments Preview:'));
             reviewComments.forEach((comment, idx) => {
-                console.log(`${idx + 1}. ${comment.path}:${comment.line} [${comment.side}] — ${comment.body}`);
+                console.log(`${idx + 1}. ${comment.path}:${comment.position} — ${comment.body}`);
             });
             const shouldApprove = allApproved;
             const hasInlineComments = reviewComments.length > 0;

package/dist/github/github.js

@@ -81,30 +81,29 @@ export async function submitReview(prNumber, body, event, comments) {
     const token = await ensureGitHubAuth();
     const { owner, repo } = await getRepoDetails();
     const url = `https://api.github.com/repos/${owner}/${repo}/pulls/${prNumber}/reviews`;
+    // Prepare payload
+    const payload = { body, event };
+    if (comments && comments.length > 0) {
+        payload.comments = comments;
+    }
     const res = await fetch(url, {
         method: 'POST',
         headers: {
             Authorization: `token ${token}`,
             Accept: 'application/vnd.github.v3+json',
         },
-        body: JSON.stringify({
-            body,
-            event,
-            comments,
-        }),
+        body: JSON.stringify(payload),
     });
     if (!res.ok) {
         const errorText = await res.text();
-        // Attempt to parse error body
         let parsed = {};
         try {
             parsed = JSON.parse(errorText);
         }
         catch (_) {
-            // leave as raw text if parsing fails
+            // fallback to raw text
         }
-        const knownErrors = Array.isArray(parsed.errors) ? parsed.errors.join('; ') : '';
-        // Handle known error cases
+        const knownErrors = Array.isArray(parsed.errors) ? parsed.errors.map((e) => e.message || e).join('; ') : '';
         if (res.status === 422) {
             if (knownErrors.includes('Can not approve your own pull request')) {
                 console.warn(`⚠️ Skipping approval: You cannot approve your own pull request.`);
@@ -114,8 +113,8 @@ export async function submitReview(prNumber, body, event, comments) {
                 console.warn(`⚠️ Cannot post comments: PR has no diff.`);
                 return;
             }
-            if (knownErrors.includes('path is missing') || knownErrors.includes('line is missing')) {
-                console.warn(`⚠️ Some inline comments are missing a path or line number. Skipping review.`);
+            if (knownErrors.includes('path is missing') || knownErrors.includes('line is missing') || knownErrors.includes('position is missing')) {
+                console.warn(`⚠️ Some inline comments are missing required fields. Skipping review.`);
                 return;
             }
             if (knownErrors.includes('Position is invalid') || knownErrors.includes('line must be part of the diff')) {
@@ -123,7 +122,6 @@ export async function submitReview(prNumber, body, event, comments) {
                 return;
             }
         }
-        // Unknown error
         throw new Error(`Failed to submit review: ${res.status} ${res.statusText} - ${errorText}`);
     }
     console.log(`✅ Submitted ${event} review for PR #${prNumber}`);

package/dist/github/repo.js

@@ -17,7 +17,7 @@ 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)?$/);
+        const match = originUrl.match(/github[^:/]*[:/](.+?)(?:\.git)?$/);
         if (!match)
             throw new Error("❌ Could not parse GitHub repo from origin URL.");
         const [owner, repo] = match[1].split('/');

package/dist/lib/generate.js

@@ -1,6 +1,14 @@
 // File: lib/generate.ts
 import { Spinner } from './spinner.js';
+import { readConfig } from '../config.js';
 export async function generate(input, model) {
+    const contextLength = readConfig().contextLength ?? 8192;
+    let prompt = input.content;
+    if (prompt.length > contextLength) {
+        console.warn(`⚠️ Warning: Input prompt length (${prompt.length}) exceeds model context length (${contextLength}). ` +
+            `The model may truncate or not handle the entire prompt. Truncating input.`);
+        prompt = prompt.slice(0, contextLength);
+    }
     const spinner = new Spinner(`🧠 Thinking with ${model}...`);
     spinner.start();
     try {
@@ -9,7 +17,7 @@ export async function generate(input, model) {
             headers: { 'Content-Type': 'application/json' },
             body: JSON.stringify({
                 model,
-                prompt: input.content,
+                prompt, // use truncated prompt here
                 stream: false,
             }),
         });

package/dist/pipeline/modules/commentModule.js

@@ -1,26 +1,57 @@
 import { Config } from '../../config.js';
 import { generate } from '../../lib/generate.js';
+import { detectFileType } from '../../fileRules/detectFileType.js';
 export const addCommentsModule = {
     name: 'addComments',
-    description: 'Adds meaningful // comments to each block of code',
+    description: 'Adds meaningful comments to any file type (code, config, or data)',
     async run(input) {
         const model = Config.getModel();
-        const lang = Config.getLanguage();
+        const fileType = detectFileType(input.filepath || '');
+        // Map file types to valid comment syntax
+        const commentMap = {
+            javascript: '//',
+            typescript: '//',
+            java: '//',
+            rust: '//',
+            c: '//',
+            cpp: '//',
+            csharp: '//',
+            go: '//',
+            swift: '//',
+            kotlin: '//',
+            scala: '//',
+            python: '#',
+            ruby: '#',
+            php: '//',
+            shell: '#',
+            bash: '#',
+            config: '#',
+            yaml: '#',
+            markdown: '<!-- -->',
+            html: '<!-- -->',
+            xml: '<!-- -->',
+            json: '/* */',
+            sql: '--',
+            csv: '#',
+            tsv: '#',
+            text: '#',
+        };
+        const commentSyntax = commentMap[fileType] || '//';
         const prompt = `
-You are a senior ${lang.toUpperCase()} engineer reviewing source code.
+You are a senior engineer reviewing a ${fileType} file.
 
-Your task is to add clear and insightful single-line comments to the code.
+Your task is to add clear, helpful, and accurate comments using "${commentSyntax}" syntax.
+This applies to *every* section where an explanation could help — even for simple code or configuration.
 
-⚠️ VERY IMPORTANT RULES:
-- You MUST return the ENTIRE original code.
-- You MUST NOT remove, replace, reformat, or alter ANY code.
-- Only add single-line // comments to complex or non-obvious parts of the code.
-- Do NOT wrap the code in markdown or code blocks.
-- The code should be valid ${lang.toUpperCase()} after your changes.
+Rules:
+- Always return the full original file with comments added.
+- Preserve all formatting, whitespace, and code exactly.
+- Use only "${commentSyntax}" comments that are valid for ${fileType}.
+- Do not wrap the output in markdown or code fences.
 
---- CODE START ---
+--- FILE START ---
 ${input.content}
---- CODE END ---
+--- FILE END ---
 `.trim();
         const response = await generate({ content: prompt }, model);
         return { content: response.content === 'NO UPDATE' ? '' : response.content };

package/dist/utils/changeLogPrompt.js

@@ -1,28 +1,32 @@
 // src/utils/changelogPrompt.ts
+import chalk from 'chalk';
 import readline from 'readline';
-export async function askChangelogApproval(entry) {
+export async function askChangelogApproval(changelogEntry) {
     return new Promise((resolve) => {
-        console.log('\n📜 Proposed changelog entry:\n');
-        console.log(entry);
         console.log('\n---');
-        console.log('1) ✅ Accept and stage');
+        console.log(chalk.yellow('Suggested changelog entry:\n'));
+        console.log(changelogEntry);
+        console.log('\nOptions:');
+        console.log('1) ✅ Accept');
         console.log('2) 🔁 Regenerate');
-        console.log('3) ❌ Skip changelog');
-        const rl = readline.createInterface({
-            input: process.stdin,
-            output: process.stdout,
-        });
-        rl.question('\n👉 Choose an option [1-3]: ', (answer) => {
+        console.log('3) 🖋️ Edit');
+        console.log('4) ❌ Skip');
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        rl.question('\n👉 Choose an option [1-4]: ', (answer) => {
             rl.close();
-            switch (answer.trim()) {
+            switch (answer) {
                 case '1':
                     resolve('yes');
                     break;
                 case '2':
                     resolve('redo');
                     break;
+                case '3':
+                    resolve('edit');
+                    break;
+                case '4':
                 default:
-                    resolve('no');
+                    resolve('skip');
                     break;
             }
         });

package/dist/utils/editor.js

@@ -0,0 +1,16 @@
+import os from 'os';
+import fs from 'fs';
+import path from 'path';
+import { spawnSync } from 'child_process';
+export async function openTextEditor(initialContent, filename) {
+    const tmpFilePath = path.join(os.tmpdir(), filename);
+    fs.writeFileSync(tmpFilePath, initialContent, 'utf-8');
+    const editor = process.env.EDITOR || (process.platform === 'win32' ? 'notepad' : 'vi');
+    spawnSync(editor, [tmpFilePath], { stdio: 'inherit' });
+    const editedContent = fs.readFileSync(tmpFilePath, 'utf-8');
+    return editedContent
+        .split('\n')
+        .filter(line => !line.trim().startsWith('#'))
+        .join('\n')
+        .trim();
+}

package/dist/utils/normalizePath.js

@@ -1,4 +1,5 @@
 // src/utils/normalizePath.ts
+import os from 'os';
 import path from "path";
 /**
  * Normalizes a path string for loose, fuzzy matching:
@@ -11,6 +12,9 @@ export function normalizePathForLooseMatch(p) {
 }
 // Helper to normalize and resolve paths to a consistent format (forward slashes)
 export function normalizePath(p) {
+    if (p.startsWith('~')) {
+        p = path.join(os.homedir(), p.slice(1));
+    }
     return path.resolve(p).replace(/\\/g, '/');
 }
 export function getRepoKeyForPath(pathToMatch, config) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scai",
-  "version": "0.1.82",
+  "version": "0.1.84",
   "type": "module",
   "bin": {
     "scai": "./dist/index.js"
@@ -52,7 +52,7 @@
     "@types/better-sqlite3": "^7.6.13",
     "@types/columnify": "^1.5.4",
     "@types/jest": "^30.0.0",
-    "@types/node": "^24.1.0",
+    "@types/node": "^24.2.1",
     "@types/proper-lockfile": "^4.1.4",
     "jest": "^30.0.2",
     "ts-jest": "^29.4.0",

package/LICENSE

@@ -1,4 +0,0 @@
-Free for personal and internal company use only.
-Commercial use (resale, SaaS, inclusion in paid tools) is prohibited.
-Contact me for commercial licensing.
-

package/README.md

@@ -1,452 +0,0 @@
-# ⚙️ scai — Smart Commit AI ✨
-
-> AI-powered CLI tool for commit messages **and** pull request reviews — using local models.
-
-**scai** is your AI pair‑programmer in the terminal. Focus on coding while scai:
-
-- 🤖 **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  
-
----
-
-## 🚀 Features
-
-- ⚡ Powered by open-source models (e.g. `llama3`, `codellama`)  
-- 🔍 Full-text indexing & semantic search (ALPHA)  
-- 🛠️ Built with Node.js and TypeScript  
-- ✅ Easily configurable via CLI or global flags  
-
----
-
-## ❤️ Why Local AI?
-
-**Your code stays yours.**  
-scai runs entirely on your machine and doesn't require cloud APIs or API keys. That means:
-
-- ✅ **Privacy-first**: no telemetry, no server round-trips  
-- ✅ **EU & GDPR-friendly**: designed with compliance in mind  
-- ✅ **Developer control**: full transparency and override options  
-- ✅ **Offline support**: works even without an internet connection  
-
----
-
-## 📦 Installation
-
-1. **Install Ollama (for local models)**  
-   - macOS: `brew install ollama`  
-   - Windows: [Download here](https://ollama.com/download)  
-   - Start Ollama after installing.
-
-2. **Install scai globally:**  
-   ```bash
-   npm install -g scai
-    ```
-
-3. **Initialize models:**
-
-   ```bash
-   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!
-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/personal-access-tokens](https://github.com/settings/personal-access-tokens)
-
-   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 index set /path/to/repo
-   ```
-
-   This is the repo from which scai will look up pull requests that can be reviewed. 
-
----
-## ⚒️ Usage Overview
-### 🧠 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
-
-
-SCAI supports an integrated review flow for GitHub pull requests. To get started:
-
-1. **Set your working index directory (once per repo):**
-
-   ```sh
-   scai index set /path/to/repo
-   ```
-
-2. **Authenticate with GitHub:**
-   ```sh
-   scai git review
-   ```
-
-   This command will query you for the Personal Access Token and set it for you. 
-   You may also do this with the auth commands below
-
-   ```sh
-   scai auth set
-   scai auth check
-   ```
-
-3. **Fetch and review pull requests:**
-
-   ```sh
-   scai git review
-   ```
-
-   Use `-a` to list all PRs that require a review:
-
-   ```sh
-   scai git review -a
-   ```
-
-#### Example Workflow
-
-```sh
-$ scai git review -a
-📦 Resolving GitHub repo info from indexDir: ./
-🔗 Git origin URL: git@github.com:org/repo.git
-✅ Parsed: owner='org', repo='repo'
-👤 Authenticated user: dev-user123
-
-🔍 Fetching pull requests and diffs...
-✅ Fetched 5 PR(s) with diffs.
-
-📦 Open Pull Requests with review requested:
-| # | ID   | TITLE                         | AUTHOR     | STATUS | CREATED    | REVIEWERS                     | REVIEWS             |
-| - | ---- | ----------------------------- | ---------- | ------ | ---------- | ----------------------------- | ------------------- |
-| 1 | #120 | fix/session-timeout         | dev-alice  | Open   | 2025-08-08 | code-analyzer\[bot], dev-bob  | ✅ Approved          |
-| 2 | #118 | feature/1482-support-wfs2   | dev-carol  | Open   | 2025-08-07 | code-analyzer\[bot], dev-dave | ✅ Approved          |
-| 3 | #117 | refactor/win-server-support | dev-erin   | Open   | 2025-08-06 | dev-frank, dev-alice          | ❌ Changes Requested |
-| 4 | #114 | bump/vue-i18n-9.14.5        | dependabot | Open   | 2025-08-04 | code-analyzer\[bot]           | ✅ Approved          |
-| 5 | #113 | bugfix/null-navigator-check | dev-bob    | Open   | 2025-08-03 | dev-alice, dev-carol          | ✅ Approved          |
-
-👉 Choose a PR to review [1-2]: 1
-✅ Model response received.
-
-💡 AI-suggested review:
-
-Solid improvement — this patch improves session stability and handles async state more reliably. 
-You might consider renaming `sessionManager` to better reflect its dual role in auth and persistence.
-
----
-1) ✅ Approve
-2) ❌ Reject
-3) ✍️ Edit
-4) Write your own review
-5) 🚪 Cancel
-```
-
-
-
-### 🔧  How to Use `scai git commit`
-
-Use AI to suggest a meaningful commit message based on your staged code:
-
-```bash
-git add .
-scai git commit
-```
-
-You can also include a changelog entry along with the commit:
-
-```bash
-scai git commit --changelog
-```
-
-This will:
-1. Suggest a commit message based on your `git diff --cached`
-2. Propose a changelog entry (if relevant)
-3. Allow you to approve, regenerate, or skip the changelog
-4. Automatically stage and commit the changes
-
----
-
-### 📝 Generate a Standalone Changelog Entry
-
-If you want to generate a changelog entry without committing:
-
-```bash
-scai gen changelog
-```
-
-This will:
-- Analyze the current `git diff` (staged or unstaged)
-- Propose a list of **user-facing changes** in clean markdown bullet points
-- Let you accept, regenerate, or skip the update
-- Append the entry to `CHANGELOG.md` and stage it if accepted
-
-
-### 🛠️ Code Generation Commands (`gen` group)
-
-```bash
-scai gen summ <file>
-scai gen comm <file>
-scai gen changelog
-scai gen tests <file>
-```
-
-* `summ`: Summarize a file
-* `comm`: Add comments to a file
-* `changelog`: Update or create `CHANGELOG.md` from Git diff
-* `tests`: Create Jest test stubs (ALPHA)
-
-You can also pipe file content directly:
-
-```bash
-cat src/utils/math.ts | scai gen summ
-```
-
----
-
-## ⚙️ Configuration
-
-scai stores settings in `~/.scai/config.json`. You can override or view them:
-
-* **Set model:**
-
-  ```bash
-  scai set model codellama:7b
-  ```
-* **Set language:**
-
-  ```bash
-  scai set lang ts
-  ```
-* **Show config:**
-
-  ```bash
-  scai config
-  ```
-
-<br>
-
-## 🔁 Background Daemon and Indexing ⚠️ ALPHA Notice
-
-These features are experimental and subject to change:
-
-* `index`, `find`, `ask`
-* `daemon`, `stop-daemon`
-* `gen tests` (test generation)
-
-<br>
-
-## Commands
-
-### `index`
-The `index` command is used to manage and perform operations on the indexed files and repositories.
-
-#### `scai index start`
-
-Index supported files in the configured index directory.
-
-```bash
-scai index set <dir>
-```
-
-Set and activate the index directory.
-```bash
-scai index list
-```
-
-List all indexed repositories.
-```bash
-scai index switch
-```
-
-Switch active repository (by key or indexDir). Run without input for an interactive list of repositories.
-
-
---- 
-
-> **Note:** Indexing very large repositories (millions of lines) may take **hours or days**. Please be patient, and only index huge codebases if you are ok with some extra processing taking place on your computer.
-
-The `scai index` command **automatically** starts a background daemon that continuously:
-
-* Scans your target directory
-* Summarizes new or changed files
-* Updates embeddings and the search index
-
-You won't gain much value from the index unless you scope it to one repository. 
-
----
-
-### 🔍 Codebase Search & Ask (ALPHA)
-
-> **Important:** You must `index` a **code repository** first or `find` and `ask` have no context to work with.
-
-1. **Set index directory:**
-
-    ```bash
-    scai index set /path/to/repo
-    ```
-
-2. **Index your repo (once):**
-
-   ```bash
-   scai index start
-   ```
-
-3. The daemon is designed to **consume minimal resources** and run unobtrusively. You can control it with:
-
-    ```bash
-    scai daemon        # Start or show daemon status
-    scai stop-daemon   # Stop the background indexer
-    ```
-
-
-4. **Keyword search:**
-
-   ```bash
-   scai find YourClassName
-   ```
-
-5. **Natural-language questions:**
-
-### 🧠 Natural-language questions
-
-Ask questions about your codebase using `scai ask`.
-
-You can run it in two ways:
-
-1. **Inline question**
-
-   ```bash
-   scai ask "How does the controller work?"
-   ```
-
-2. **Interactive prompt**
-
-   ```bash
-   scai ask
-   ```
-
-   **Press enter**
-   , then type your question when prompted:
-
-   ```
-   > How does the controller work?
-   ```
-
-   </br>
-
-### 🚨 **OBS** 🚨
-
-`find` and `ask` rely on that index—without it they will return no useful results.
-
----
-
- Note 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.
-
-If you're upgrading from an earlier version, please run the following commands to avoid indexing issues:
-
-```bash
-scai reset-db
-scai index
-```
-</br>
-
----
-
-## 🛍️ Maintenance & Utilities
-
-* **Reset database (w/ backup):**
-
-  ```bash
-  scai reset-db
-  ```
-* **Backup only of `~/.scai`:**
-
-  ```bash
-  scai backup
-  ```
-
----
-
-## 🧺 Module Pipeline Mode
-
-For custom pipelines on a single file:
-
-```bash
-scai src/file.ts -m summary,comments
-```
----
-
-## 🔐 License & Fair Use
-
-**scai is free to use** for individuals, teams, and commercial projects.
-
-You may:
-
-* ✅ Use internally or commercially
-* ✅ Fork and improve
-* ✅ Recommend to others
-
-You may **not**:
-
-* ❌ Resell as a product or service
-* ❌ Claim ownership of the tool
-
-</br>
-
-### 📄 License
-
-Free for personal and internal company use only.
-Commercial use (resale, SaaS, inclusion in paid tools) is prohibited.
-Contact me for commercial licensing.
-
----
-
-</br>
-
-## 🙌 Feedback
-
-Questions, ideas, or bugs?  
-Ping [@ticcr](https://bsky.app/profile/ticcr.xyz) on Bluesky — I'd love to hear your thoughts!
-
----