scai 0.1.92 → 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

@@ -121,4 +121,8 @@ Type handling with the module pipeline
 
 ## 2025-08-19
 
-* Improved line classification and merging logic
+* 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/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.92",
+  "version": "0.1.93",
   "type": "module",
   "bin": {
     "scai": "./dist/index.js"