scai 0.1.91 → 0.1.93

package/README.md

@@ -226,14 +226,24 @@ This will:
 
 ```bash
 scai gen summ <file>
-scai gen comm <file>
+scai gen comm <file|folder...>
 scai gen changelog
 scai gen tests <file>
 ```
 
 * `summ`: Summarize a file
-* `comm`: Add comments to a file
+
+* `comm`: Add comments to one or more files, or to all matching files in a folder (recursive).
+  **Example:**
+
+  ```bash
+  scai gen comm src/ utils/helpers.ts
+  ```
+
+  This will add comments to all `.ts` and `.js` files under `src/` and to `utils/helpers.ts`.
+
 * `changelog`: Update or create `CHANGELOG.md` from Git diff
+
 * `tests`: Create Jest test stubs (ALPHA)
 
 You can also pipe file content directly:
@@ -242,6 +252,7 @@ You can also pipe file content directly:
 cat src/utils/math.ts | scai gen summ
 ```
 
+
 ---
 
 ## ⚙️ Configuration

package/dist/CHANGELOG.md

@@ -117,4 +117,12 @@ Type handling with the module pipeline
 ## 2025-08-18
 
 • Add interactive delete repository command
-• Refactor DeleteIndex command to handle repository deletion correctly
+• Refactor DeleteIndex command to handle repository deletion correctly
+
+## 2025-08-19
+
+* Improved line classification and merging logic
+
+## 2025-08-19
+
+• Update `gen` command's `comm` subcommand to allow targeting files or folders

package/dist/index.js

@@ -31,6 +31,7 @@ import { addCommentsModule } from './pipeline/modules/commentModule.js';
 import { generateTestsModule } from './pipeline/modules/generateTestsModule.js';
 import { preserveCodeModule } from './pipeline/modules/preserveCodeModule.js';
 import { runInteractiveDelete } from './commands/DeleteIndex.js';
+import { resolveTargetsToFiles } from './utils/resolveTargetsToFiles.js';
 // 🎛️ CLI Setup
 const cmd = new Command('scai')
     .version(version)
@@ -104,10 +105,13 @@ auth
 // 🛠️ Group: `gen` commands for content generation
 const gen = cmd.command('gen').description('Generate code-related output');
 gen
-    .command('comm <file>')
-    .description('Write comments for the given file')
-    .action((file) => {
-    handleAgentRun(file, [addCommentsModule, preserveCodeModule]);
+    .command("comm <targets...>")
+    .description("Write comments for the given file(s) or folder(s)")
+    .action(async (targets) => {
+    const files = await resolveTargetsToFiles(targets, [".ts", ".js"]);
+    for (const file of files) {
+        await handleAgentRun(file, [addCommentsModule, preserveCodeModule]);
+    }
 });
 gen
     .command('changelog')

package/dist/pipeline/modules/preserveCodeModule.js

@@ -57,53 +57,48 @@ export const preserveCodeModule = {
         const fixedLines = [];
         let origIndex = 0;
         let newIndex = 0;
-        while (origIndex < origLines.length && newIndex < newLines.length) {
+        // Track all inserted comment blocks globally
+        const insertedBlocks = new Set();
+        while (origIndex < origLines.length) {
             const origLine = origLines[origIndex];
-            const newLine = newLines[newIndex];
-            // If either current line is a comment → treat whole comment block
-            let lastInsertedModelBlock = [];
-            if (classifyLine(origLine) !== "code" || classifyLine(newLine) !== "code") {
+            // If this is a comment line in original or model
+            if (classifyLine(origLine) !== "code" || classifyLine(newLines[newIndex] ?? "") !== "code") {
                 const origBlock = collectBlock(origLines, origIndex);
                 const modelBlock = collectBlock(newLines, newIndex);
-                // Compare with last inserted block
-                if (!blocksEqual(modelBlock, lastInsertedModelBlock)) {
-                    if (blocksEqual(origBlock, modelBlock)) {
-                        fixedLines.push(...origBlock);
-                    }
-                    else {
-                        const seen = new Set(trimBlock(modelBlock));
-                        fixedLines.push(...modelBlock);
-                        for (const line of origBlock) {
-                            if (!seen.has(line.trim())) {
-                                fixedLines.push(line);
-                            }
-                        }
+                // Merge: model block first, then any orig lines not in model
+                const seen = new Set(trimBlock(modelBlock));
+                const mergedBlock = [...modelBlock];
+                for (const line of origBlock) {
+                    if (!seen.has(line.trim())) {
+                        mergedBlock.push(line);
                     }
-                    // Update lastInsertedModelBlock
-                    lastInsertedModelBlock = [...modelBlock];
+                }
+                // Create a key for duplicate detection
+                const mergedKey = JSON.stringify(trimBlock(mergedBlock));
+                // Insert only if this block was never inserted before
+                if (!insertedBlocks.has(mergedKey)) {
+                    fixedLines.push(...mergedBlock);
+                    insertedBlocks.add(mergedKey);
                 }
                 else {
                     console.log("Skipping duplicate block (already inserted)");
                 }
+                // Advance indices past the entire blocks
                 origIndex += origBlock.length;
                 newIndex += modelBlock.length;
                 continue;
             }
-            // Non-comment lines
-            if (origLine.trim() === newLine.trim()) {
-                fixedLines.push(newLine);
-            }
-            else {
-                fixedLines.push(origLine);
-            }
+            // Non-comment line
+            const newLine = newLines[newIndex] ?? "";
+            fixedLines.push(origLine.trim() === newLine.trim() ? newLine : origLine);
             origIndex++;
             newIndex++;
         }
-        // Add trailing lines from original (if model ran out first)
+        // Add any remaining original lines if model ran out
         while (origIndex < origLines.length) {
             fixedLines.push(origLines[origIndex++]);
         }
-        // Add trailing comments from model
+        // Add trailing comments from model if any
         while (newIndex < newLines.length) {
             if (classifyLine(newLines[newIndex]) !== "code") {
                 fixedLines.push(newLines[newIndex]);

package/dist/utils/resolveTargetsToFiles.js

@@ -0,0 +1,29 @@
+import fs from "fs/promises";
+import path from "path";
+export async function resolveTargetsToFiles(targets, exts) {
+    const files = [];
+    for (const target of targets) {
+        const stat = await fs.stat(target);
+        if (stat.isDirectory()) {
+            files.push(...await collectFilesRecursive(target, exts));
+        }
+        else {
+            files.push(target);
+        }
+    }
+    return files;
+}
+async function collectFilesRecursive(dir, exts) {
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...await collectFilesRecursive(fullPath, exts));
+        }
+        else if (exts.includes(path.extname(entry.name))) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}

package/package.json

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