scai 0.1.92 → 0.1.94

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:
@@ -264,22 +274,12 @@ scai stores settings in `~/.scai/config.json`. You can override or view them:
   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.
+The `index` command is used to manage and perform operations on the indexed files and repositories. It allows you to control which repository you're working with and have indexed. 
 
 #### `scai index start`
 
@@ -289,6 +289,12 @@ Index supported files in the configured index directory.
 scai index set <dir>
 ```
 
+Or just this for cwd (current working dir)
+
+```bash
+scai index set
+```
+
 Set and activate the index directory.
 ```bash
 scai index list
@@ -312,6 +318,104 @@ scai index delete
 
 --- 
 
+## 🛍️ Maintenance & Utilities
+# Database Commands
+
+Your CLI now supports a set of **database management commands** under the `db` namespace. These commands allow you to check the status of the database, reset it, or run migrations.
+
+---
+
+### 📋 Available Commands
+
+#### 🔍 Check Database
+
+```bash
+scai db check
+```
+
+Runs the **dbcheck** script to verify the database status.
+
+* Useful for quickly checking if the database is healthy.
+* Prints detailed output directly in the console.
+
+---
+
+#### ♻️ Reset Database
+
+```bash
+scai db reset
+```
+
+Deletes and resets the SQLite database.
+
+* Will ask for confirmation before proceeding.
+* Respond with `y` or `Y` to confirm.
+* Any other key (including `n`, `N`, or just pressing **Enter**) will cancel the reset.
+
+---
+
+#### 📦 Run Migrations
+
+```bash
+scai db migrate
+```
+
+Executes all database migration scripts.
+
+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 db reset
+scai index
+```
+</br>
+
+---
+
+### ✅ Example Workflow
+
+1. **Check** current database state:
+
+   ```bash
+   scai db check
+   ```
+
+2. Confirm you're in the correct repo. 
+
+   ```bash
+   scai index list
+   ```
+
+   Use the switch command to switch if necessary.
+   
+   ```bash
+   scai index switch
+   ```
+
+2. If necessary, **reset** the database:
+
+   ```bash
+   scai db reset
+   ```
+
+   → Confirm with `y` when prompted.
+   
+   </br>
+
+---
+
+## 🔁 Background Daemon and Indexing ⚠️ ALPHA Notice
+
+These features are experimental and subject to change:
+
+* `find`, `ask`
+* `daemon`, `stop-daemon`
+* `gen tests` (test generation)
+
+<br>
+
 > **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:
@@ -324,8 +428,6 @@ 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:**
@@ -389,40 +491,16 @@ You can run it in two ways:
 
 ---
 
- 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.
+### Backup only of `~/.scai`:**
 
-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`:**
+Creates a backup of the .scai folder in the user root dir. 
 
   ```bash
   scai backup
   ```
 
----
-
-## 🧺 Module Pipeline Mode
-
-For custom pipelines on a single file:
-
-```bash
-scai src/file.ts -m summary,comments
-```
+Results in this:
+~/.scai_backup_2025-08-12T06-58-00-227Z/
 ---
 
 ## 🔐 License & Fair Use

package/dist/CHANGELOG.md

@@ -121,4 +121,14 @@ 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
+
+## 2025-08-20
+
+• Add DB-related commands to db subcommand (check, reset, migrate)
+• Update table view limits for files and functions in dbcheck.ts
+• Improved resetDatabase command with confirmation prompt before deleting database

package/dist/commands/ResetDbCmd.js

@@ -1,12 +1,28 @@
 import fs from 'fs';
 import path from 'path';
 import lockfile from 'proper-lockfile';
+import readline from 'readline';
 import { backupScaiFolder } from '../db/backup.js';
 import { getDbPathForRepo, getDbForRepo } from '../db/client.js';
 export async function resetDatabase() {
+    const dbPath = getDbPathForRepo();
+    console.log(`⚠️  You are about to delete the database at: ${dbPath}`);
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const confirm = await new Promise((resolve) => {
+        rl.question('Are you sure you want to proceed? (y/N): ', (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase() === 'y');
+        });
+    });
+    if (!confirm) {
+        console.log('❌ Reset aborted. Database was not deleted.');
+        return;
+    }
     console.log('🔁 Backing up existing .scai folder...');
     await backupScaiFolder();
-    const dbPath = getDbPathForRepo();
     // Close the DB connection
     try {
         const db = getDbForRepo();

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')
@@ -184,14 +188,13 @@ index
     .action(() => {
     runInteractiveDelete();
 });
-// This will help resolve the current directory in an ES Module
-cmd
-    .command('check-db')
+const db = cmd.command('db').description('Database operations');
+db
+    .command('check')
     .description('Run the dbcheck script to check the database status')
     .action(() => {
     const __filename = fileURLToPath(import.meta.url);
     const __dirname = dirname(__filename);
-    // Go up two levels from dist/commands → dist → then into dist/scripts/dbcheck.js
     const scriptPath = resolve(__dirname, '..', 'dist/scripts', 'dbcheck.js');
     console.log(`🚀 Running database check script: ${scriptPath}`);
     try {
@@ -201,6 +204,14 @@ cmd
         console.error('❌ Error running dbcheck script:', err instanceof Error ? err.message : err);
     }
 });
+db
+    .command('reset')
+    .description('Delete and reset the SQLite database')
+    .action(() => resetDatabase());
+db
+    .command('migrate')
+    .description('Run DB migration scripts')
+    .action(runMigrateCommand);
 cmd
     .command('backup')
     .description('Backup the current .scai folder')
@@ -226,10 +237,6 @@ cmd
     .command('stop-daemon')
     .description('Stop the background summarizer daemon')
     .action(runStopDaemonCommand);
-cmd
-    .command('migrate')
-    .description('Run DB migration scripts')
-    .action(runMigrateCommand);
 cmd
     .command('inspect')
     .argument('<filepath>', 'Path to the file to inspect')
@@ -237,10 +244,6 @@ cmd
     .action(async (filepath) => {
     await runInspectCommand(filepath);
 });
-cmd
-    .command('reset-db')
-    .description('Delete and reset the SQLite database')
-    .action(() => resetDatabase());
 cmd
     .command('pipe')
     .description('Run a module pipeline on a given file')

package/dist/scripts/dbcheck.js

@@ -50,7 +50,7 @@ const summaries = db.prepare(`
   SELECT id, substr(summary, 1, 50) || '...' AS short_summary
   FROM files
   WHERE summary IS NOT NULL AND summary != ''
-  LIMIT 10
+  LIMIT 5
 `).all();
 summaries.forEach(row => {
     console.log(`${row.id.toString().padEnd(4)}  ${row.short_summary}`);
@@ -60,7 +60,7 @@ const embeddings = db.prepare(`
   SELECT id, substr(embedding, 1, 50) || '...' AS short_embedding
   FROM files
   WHERE embedding IS NOT NULL AND embedding != ''
-  LIMIT 10
+  LIMIT 5
 `).all();
 embeddings.forEach(row => {
     console.log(`${row.id.toString().padEnd(4)}  ${row.short_embedding}`);
@@ -181,14 +181,14 @@ catch (err) {
     console.error('❌ Error accessing function_calls table:', err.message);
 }
 // === Random Summary Samples ===
-console.log('\n🧾 10 Random Summaries (ID + Preview):');
+console.log('\n🧾 Random Summaries (ID + Preview):');
 console.log('-------------------------------------------');
 const randomSummaries = db.prepare(`
   SELECT id, filename, substr(summary, 1, 1000) || '...' AS preview
   FROM files
   WHERE summary IS NOT NULL AND summary != ''
   ORDER BY RANDOM()
-  LIMIT 10
+  LIMIT 5
 `).all();
 randomSummaries.forEach(row => {
     console.log(`📄 [${row.id}] ${row.filename}: ${row.preview}`);
@@ -200,27 +200,27 @@ const randomFunctions = db.prepare(`
   SELECT id, name, file_id, substr(content, 1, 100) || '...' AS preview
   FROM functions
   ORDER BY RANDOM()
-  LIMIT 20
+  LIMIT 5
 `).all();
 randomFunctions.forEach(row => {
     console.log(`🔹 [${row.id}] ${row.name} (file_id: ${row.file_id})`);
     console.log(`   ${row.preview}\n`);
 });
-// === Column View of 100 Files ===
-console.log('\n📊 Table View: First 500 Files');
+// === Column View of Files ===
+console.log('\n📊 Table View: Files');
 console.log('-------------------------------------------');
 const fileRows = db.prepare(`
   SELECT id, filename, type, processing_status, functions_extracted_at, length(summary) AS summary_len
   FROM files
-  LIMIT 500
+  LIMIT 50
 `).all();
 console.table(fileRows);
-// === Column View of 100 Functions ===
-console.log('\n📊 Table View: First 500 Functions');
+// === Column View of Functions ===
+console.log('\n📊 Table View: Functions');
 console.log('-------------------------------------------');
 const functionRows = db.prepare(`
   SELECT id, file_id, name, start_line, end_line, length(content) AS length
   FROM functions
-  LIMIT 500
+  LIMIT 50
 `).all();
 console.table(functionRows);

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.94",
   "type": "module",
   "bin": {
     "scai": "./dist/index.js"