scai 0.1.14 → 0.1.16

package/README.md

@@ -30,8 +30,6 @@ We believe your code — and your workflow — should stay **yours**. scai runs
 ✅ Backed by open-source models  
 ✅ Designed for CLI-first developers
 
----
-
 ## 📦 Installation
 
 1. **Install [Ollama](https://ollama.com)**  
@@ -59,8 +57,6 @@ This will:
 - Start the Ollama background server
 - Download required models (`llama3`, etc.)
 
----
-
 ## 🧪 Usage Examples
 
 ### 💬 Suggest a commit message
@@ -108,7 +104,6 @@ To pipe input for summarization:
 cat <file> | scai summ
 ```
 
-
 ---
 
 ### 📝 Update the changelog
@@ -121,6 +116,14 @@ Analyzes the current Git diff and updates (or creates) a `CHANGELOG.md` file wit
 
 ---
 
+### 📦 Module Pipeline (Advanced Usage)
+
+For more advanced functionality, scai allows you to run custom pipelines with multiple modules to process code. You can specify multiple modules to be run, such as comment, summary, cleanup, and more.
+
+```bash
+scai <file> --modules comment,summary,cleanup
+```
+
 ## 🔐 License & Fair Use
 
 **scai is free to use** for individuals, teams, and companies — including in commercial work.
@@ -137,5 +140,3 @@ But you may not:
 - ❌ Claim ownership of the tool
 
 See [LICENSE](./LICENSE) for full terms.
-
----

package/dist/commands/ChangeLogUpdateCmd.js

@@ -2,7 +2,7 @@
 import { execSync } from 'child_process';
 import fs from 'fs/promises';
 import path from 'path';
-import { runPromptPipeline } from '../pipeline/runPipeline.js';
+import { runModulePipeline } from '../pipeline/runModulePipeline.js';
 import { changelogModule } from '../pipeline/modules/changeLogModule.js';
 export async function handleChangelogUpdate() {
     try {
@@ -14,7 +14,7 @@ export async function handleChangelogUpdate() {
             console.log("⚠️  No staged or unstaged changes to include in changelog.");
             return;
         }
-        const result = await runPromptPipeline([changelogModule], { code: diff });
+        const result = await runModulePipeline([changelogModule], { code: diff });
         if (!result.code.trim()) {
             console.log("✅ No significant changes for changelog.");
             return;

package/dist/commands/CommitSuggesterCmd.js

@@ -11,23 +11,30 @@ function askUserToChoose(suggestions) {
         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`);
         const rl = readline.createInterface({
             input: process.stdin,
             output: process.stdout,
         });
-        rl.question(`\n👉 Choose a commit message [1-${suggestions.length + 2}]: `, (answer) => {
+        rl.question(`\n👉 Choose a commit message [1-${suggestions.length + 3}]: `, (answer) => {
             rl.close();
             const choice = parseInt(answer, 10);
-            if (isNaN(choice) || choice < 1 || choice > suggestions.length + 2) {
-                console.log('⚠️  Invalid selection. Using the first suggestion by default.');
-                resolve(0);
+            if (choice === suggestions.length + 1) {
+                resolve('regenerate');
             }
             else if (choice === suggestions.length + 2) {
                 resolve('custom');
             }
-            else {
+            else if (choice === suggestions.length + 3) {
+                resolve('cancel');
+            }
+            else if (!isNaN(choice) && choice >= 1 && choice <= suggestions.length) {
                 resolve(choice - 1);
             }
+            else {
+                console.log('⚠️ Invalid selection. Using the first suggestion by default.');
+                resolve(0);
+            }
         });
     });
 }
@@ -53,30 +60,50 @@ export async function suggestCommitMessage(options) {
             console.log('⚠️  No staged changes to suggest a message for.');
             return;
         }
-        let suggestions = [];
+        const output = await commitSuggesterModule.run({ code: diff });
+        const suggestions = output.suggestions || [];
+        if (!suggestions.length) {
+            console.log('⚠️  No commit suggestions generated.');
+            return;
+        }
+        // Show-only mode
+        if (!options.commit) {
+            console.log('\n💡 AI-suggested commit messages:\n');
+            suggestions.slice(0, 3).forEach((msg, i) => {
+                console.log(`${i + 1}) ${msg}`);
+            });
+            process.exit(0); // ensure clean exit
+        }
+        // Commit mode with selection
         let message = null;
         while (message === null) {
-            suggestions = await commitSuggesterModule.run({ code: diff }).then(out => out.suggestions || []);
             const choice = await askUserToChoose(suggestions);
-            if (choice === suggestions.length) {
+            if (choice === 'regenerate') {
                 console.log('\n🔄 Regenerating suggestions...\n');
+                const out = await commitSuggesterModule.run({ code: diff });
+                suggestions.splice(0, suggestions.length, ...(out.suggestions || []));
                 continue;
             }
             if (choice === 'custom') {
                 message = await promptCustomMessage();
-                break;
             }
-            message = suggestions[choice];
+            else if (choice === 'cancel') {
+                console.log('❌ Commit cancelled.');
+                return;
+            }
+            else {
+                message = suggestions[choice];
+            }
         }
         console.log(`\n✅ Selected commit message:\n${message}\n`);
-        if (options.commit) {
-            const commitDiff = execSync("git diff", { encoding: "utf-8" }).trim();
-            if (commitDiff) {
-                execSync("git add .", { encoding: "utf-8" });
-            }
-            execSync(`git commit -m "${message.replace(/"/g, '\\"')}"`, { stdio: 'inherit' });
-            console.log('✅ Committed with selected message.');
+        const staged = execSync("git diff --cached", { encoding: "utf-8" }).trim();
+        if (!staged) {
+            console.log("⚠️ No files are currently staged for commit.");
+            console.log("👉 Please stage your changes with 'git add <files>' and rerun the command.");
+            return;
         }
+        execSync(`git commit -m "${message.replace(/"/g, '\\"')}"`, { stdio: 'inherit' });
+        console.log('✅ Committed with selected message.');
     }
     catch (err) {
         console.error('❌ Error in commit message suggestion:', err.message);

package/dist/commands/ModulePipelineCmd.js

@@ -0,0 +1,31 @@
+import { readFileSync } from 'fs';
+import { getModuleByName } from '../registry/moduleRegistry.js';
+import { runModulePipeline } from '../pipeline/runModulePipeline.js';
+export async function runModulePipelineFromCLI(file, options) {
+    if (!options.modules) {
+        console.error('❌ No modules specified. Use --modules or -m.');
+        process.exit(1);
+    }
+    const moduleNames = options.modules.split(',').map((m) => m.trim());
+    // Read file content
+    let fileContent = '';
+    try {
+        fileContent = readFileSync(file, 'utf-8');
+    }
+    catch (err) {
+        console.error(`❌ Could not read file: ${file}`);
+        process.exit(1);
+    }
+    const input = { code: fileContent, filepath: file };
+    // Retrieve modules from the registry
+    const resolvedModules = moduleNames.map((name) => {
+        const module = getModuleByName(name);
+        if (!module) {
+            console.error(`❌ Failed to load module: ${name}`);
+            process.exit(1);
+        }
+        return module;
+    });
+    // Run the module pipeline
+    await runModulePipeline(resolvedModules, input);
+}

package/dist/commands/RefactorCmd.js

@@ -1,6 +1,6 @@
 import fs from 'fs/promises';
 import path from 'path';
-import { runPromptPipeline } from '../pipeline/runPipeline.js';
+import { runModulePipeline } from '../pipeline/runModulePipeline.js';
 import { addCommentsModule } from '../pipeline/modules/commentModule.js';
 import { cleanupModule } from '../pipeline/modules/cleanupModule.js';
 export async function handleRefactor(filepath, options = {}) {
@@ -27,7 +27,7 @@ export async function handleRefactor(filepath, options = {}) {
         // Read source code
         const originalCode = await fs.readFile(filepath, 'utf-8');
         // Run through pipeline modules
-        const refactored = await runPromptPipeline([addCommentsModule, cleanupModule], { code: originalCode });
+        const refactored = await runModulePipeline([addCommentsModule, cleanupModule], { code: originalCode });
         if (!refactored.code.trim())
             throw new Error('⚠️ Model returned empty result');
         // Save refactored output

package/dist/commands/SummaryCmd.js

@@ -1,6 +1,7 @@
 import fs from 'fs/promises';
-import { summaryModule } from '../pipeline/modules/summaryModule.js';
 import readline from 'readline';
+import { summaryModule } from '../pipeline/modules/summaryModule.js'; // Import summaryModule
+import { summarizeCode } from '../utils/summarizer.js'; // Import summarizeCode
 export async function summarizeFile(filepath) {
     let code = '';
     if (filepath) {
@@ -12,7 +13,6 @@ export async function summarizeFile(filepath) {
             return;
         }
     }
-    // ⬇️ Add this check right here
     else if (process.stdin.isTTY) {
         console.error('❌ No file provided and no piped input.\n👉 Usage: scai summ <file> or cat file | scai summ');
         return;
@@ -28,7 +28,11 @@ export async function summarizeFile(filepath) {
         }
     }
     if (code.trim()) {
-        await summaryModule.run({ code });
+        // Call the summary module to get the raw summary
+        const summary = await summaryModule.run({ code });
+        // Pass the summary text to the utility function for formatting
+        const formattedSummary = summarizeCode(summary.code);
+        console.log(formattedSummary);
     }
     else {
         console.error('❌ No code provided to summarize.');

package/dist/commands/TestGenCmd.js

@@ -1,11 +1,11 @@
 import fs from 'fs/promises';
 import { generateTestsModule } from '../pipeline/modules/generateTestsModule.js';
 import { cleanupModule } from '../pipeline/modules/cleanupModule.js';
-import { runPromptPipeline } from '../pipeline/runPipeline.js';
+import { runModulePipeline } from '../pipeline/runModulePipeline.js';
 export async function generateTests(filepath) {
     try {
         const code = await fs.readFile(filepath, 'utf-8');
-        const result = await runPromptPipeline([generateTestsModule, cleanupModule], { code, filepath });
+        const result = await runModulePipeline([generateTestsModule, cleanupModule], { code, filepath });
         console.log('✅ Test generated and cleaned up.');
     }
     catch (err) {

package/dist/index.js

@@ -1,8 +1,10 @@
 #!/usr/bin/env node
 import { Command } from "commander";
+// Importing package.json for version
 import { createRequire } from 'module';
 const require = createRequire(import.meta.url);
 const { version } = require('../package.json');
+// Importing commands
 import { checkEnv } from "./commands/EnvCmd.js";
 import { checkGit } from "./commands/GitCmd.js";
 import { suggestCommitMessage } from "./commands/CommitSuggesterCmd.js";
@@ -12,6 +14,7 @@ import { bootstrap } from './modelSetup.js';
 import { ModelConfig } from './config/ModelConfig.js';
 import { summarizeFile } from "./commands/SummaryCmd.js";
 import { handleChangelogUpdate } from './commands/ChangeLogUpdateCmd.js';
+import { runModulePipelineFromCLI } from './commands/ModulePipelineCmd.js';
 // Create the CLI instance
 const cmd = new Command('scai')
     .version(version)
@@ -63,6 +66,16 @@ cmd
     .action(() => {
     ModelConfig.logCurrentConfig();
 });
+cmd
+    .arguments('<file>')
+    .option('-m, --modules <modules>', 'Comma-separated list of modules to run (e.g., comments,cleanup,summary)')
+    .action((file, options) => {
+    if (!options.modules) {
+        console.error('❌ You must specify modules with -m or --modules');
+        process.exit(1);
+    }
+    runModulePipelineFromCLI(file, options);
+});
 // ✅ Now that commands are defined, parse args
 cmd.parse(process.argv);
 // ✅ Apply global options after parsing

package/dist/pipeline/modules/commitSuggesterModule.js

@@ -6,7 +6,7 @@ export const commitSuggesterModule = {
     async run({ code }) {
         const model = ModelConfig.getModel();
         const prompt = `
-Suggest 3 concise, conventional Git commit messages based on this diff.
+Suggest ALWAYS 3 concise, conventional Git commit messages based on this diff.
 Use this format ONLY:
 
 1. feat: ...

package/dist/pipeline/{runPipeline.js → runModulePipeline.js}

@@ -1,4 +1,4 @@
-export async function runPromptPipeline(modules, input) {
+export async function runModulePipeline(modules, input) {
     let current = input;
     // Add flag or condition for logging (optional)
     const isDebug = true;

package/dist/registry/moduleRegistry.js

@@ -0,0 +1,21 @@
+import { addCommentsModule } from '../pipeline/modules/commentModule.js';
+import { cleanupModule } from '../pipeline/modules/cleanupModule.js';
+import { summaryModule } from '../pipeline/modules/summaryModule.js';
+import { generateTestsModule } from '../pipeline/modules/generateTestsModule.js';
+import { commitSuggesterModule } from '../pipeline/modules/commitSuggesterModule.js';
+import { changelogModule } from '../pipeline/modules/changeLogModule.js';
+// Add more as needed...
+const builtInModules = {
+    comments: addCommentsModule,
+    cleanup: cleanupModule,
+    summary: summaryModule,
+    tests: generateTestsModule,
+    suggest: commitSuggesterModule,
+    changelog: changelogModule,
+};
+export function getModuleByName(name) {
+    return builtInModules[name];
+}
+export function listAvailableModules() {
+    return Object.keys(builtInModules);
+}

package/dist/utils/summarizer.js

@@ -0,0 +1,10 @@
+import { wrapText } from "./textWrapper.js";
+// src/utils/summarizer.ts
+export function summarizeCode(summaryText) {
+    // Get the terminal width (default to 80 if not available)
+    const terminalWidth = process.stdout.columns || 80;
+    // Use two-thirds of the terminal width for the wrapping
+    const twoThirdsTerminalWidth = Math.floor((terminalWidth * 2) / 3);
+    // Wrap the summary output to fit within two-thirds of the terminal width
+    return wrapText(summaryText, twoThirdsTerminalWidth);
+}

package/dist/utils/textWrapper.js

@@ -0,0 +1,18 @@
+export function wrapText(text, maxWidth) {
+    const words = text.split(' ');
+    let wrappedText = '';
+    let currentLine = '';
+    words.forEach(word => {
+        // Check if adding the word would exceed the max width
+        if ((currentLine + word).length > maxWidth) {
+            wrappedText += currentLine + '\n'; // Add the current line and start a new one
+            currentLine = word + ' '; // Start the new line with the current word
+        }
+        else {
+            currentLine += word + ' '; // Add the word to the current line
+        }
+    });
+    // Append the last line if any
+    wrappedText += currentLine;
+    return wrappedText;
+}

package/package.json

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