scai 0.1.117 → 0.1.118

package/dist/commands/ReviewCmd.js

@@ -9,11 +9,13 @@ import os from 'os';
 import path from 'path';
 import { spawnSync } from 'child_process';
 import columnify from 'columnify';
-import { Spinner } from '../lib/spinner.js'; // adjust path as needed
+import { Spinner } from '../lib/spinner.js';
+import { openDiffInVSCode } from '../utils/vscode.js';
+// --- Helper functions ---
 function truncate(str, length) {
     return str.length > length ? str.slice(0, length - 3) + '...' : str;
 }
-// Fetch open PRs with review requested
+// --- Fetch PRs with review requests ---
 export async function getPullRequestsForReview(token, owner, repo, username, branch = 'main', filterForUser = true) {
     const spinner = new Spinner('Fetching pull requests and diffs...');
     spinner.start();
@@ -24,7 +26,7 @@ export async function getPullRequestsForReview(token, owner, repo, username, bra
         for (const pr of prs) {
             const shouldInclude = !pr.draft &&
                 !pr.merged_at &&
-                (!filterForUser || pr.requested_reviewers?.some(r => r.login === username));
+                (!filterForUser || pr.requested_reviewers?.some((r) => r.login === username));
             if (!shouldInclude)
                 continue;
             try {
@@ -65,7 +67,7 @@ export async function getPullRequestsForReview(token, owner, repo, username, bra
             spinner.succeed(`Fetched ${filtered.length} PR(s) with diffs.`);
         }
         if (failedPRs.length > 0) {
-            const failedList = failedPRs.map(pr => `#${pr.number}`).join(', ');
+            const failedList = failedPRs.map((pr) => `#${pr.number}`).join(', ');
             console.warn(`⚠️ Skipped ${failedPRs.length} PR(s): ${failedList}`);
         }
         return filtered;
@@ -75,11 +77,11 @@ export async function getPullRequestsForReview(token, owner, repo, username, bra
         return [];
     }
 }
-// Prompt user to select PR
+// --- Prompt user to select PR ---
 function askUserToPickPR(prs) {
     return new Promise((resolve) => {
         if (prs.length === 0) {
-            console.log("⚠️ No pull requests with review requested.");
+            console.log('⚠️ No pull requests with review requested.');
             return resolve(null);
         }
         const rows = prs.map((pr, i) => ({
@@ -100,7 +102,7 @@ function askUserToPickPR(prs) {
                     ? chalk.red('Changes Requested')
                     : chalk.gray('—'),
         }));
-        console.log(chalk.blue("\n📦 Open Pull Requests:"));
+        console.log(chalk.blue('\n📦 Open Pull Requests:'));
         console.log(columnify(rows, {
             columnSplitter: '  ',
             headingTransform: (h) => chalk.cyan(h.toUpperCase()),
@@ -323,8 +325,14 @@ async function promptAIReviewSuggestions(aiOutput, chunkContent) {
         }
         else if (trimmed === 'r') {
             console.log(chalk.yellow('\nRegenerating suggestions...\n'));
-            const newSuggestion = await reviewModule.run({ content: chunkContent });
-            const newOutput = newSuggestion.content || aiOutput;
+            const ioInput = {
+                query: 'regenerate_chunk_review',
+                content: chunkContent
+            };
+            const newSuggestion = await reviewModule.run(ioInput);
+            const newOutput = typeof newSuggestion.data === 'string'
+                ? newSuggestion.data
+                : newSuggestion.content?.toString() || aiOutput;
             suggestions = parseAISuggestions(newOutput);
         }
         else if (trimmed === 'c') {
@@ -364,12 +372,18 @@ export async function reviewChunk(chunk, chunkIndex, totalChunks) {
     // Build colored diff
     const lines = chunk.content.split('\n');
     const coloredDiff = lines.map(colorDiffLine).join('\n');
-    // 1️⃣ Run the AI review
-    const suggestion = await reviewModule.run({
-        content: chunk.content,
-        filepath: chunk.filePath
-    });
-    const aiOutput = suggestion.content?.trim() || '1. AI review summary not available.';
+    // 1️⃣ Run the AI review using ModuleIO
+    const ioInput = {
+        query: 'review_chunk',
+        content: {
+            chunkContent: chunk.content,
+            filepath: chunk.filePath
+        }
+    };
+    const suggestion = await reviewModule.run(ioInput);
+    const aiOutput = typeof suggestion.data === 'string'
+        ? suggestion.data.trim()
+        : suggestion.content?.toString() || '1. AI review summary not available.';
     // 2️⃣ Show the diff
     console.log(`\n${chalk.bold('--- Diff ---')}\n`);
     console.log(coloredDiff);
@@ -451,8 +465,18 @@ export async function promptChunkReviewMenu() {
         process.stdin.once('data', onKeyPress);
     });
 }
-// Main command to review PR
-export async function reviewPullRequestCmd(branch = 'main', showAll = false) {
+// Helper to ask if the user wants to open the diff in VSCode
+async function askOpenInVSCode() {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        rl.question(chalk.cyan('\n💡 Open this PR diff in VS Code? [Y/n]: '), (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase() !== 'n');
+        });
+    });
+}
+// Main review command
+export async function reviewPullRequestCmd(branch = "main", showAll = false) {
     try {
         const { owner, repo } = await getRepoDetails();
         const token = await ensureGitHubAuth();
@@ -460,46 +484,58 @@ export async function reviewPullRequestCmd(branch = 'main', showAll = false) {
         const prsWithReviewRequested = await getPullRequestsForReview(token, owner, repo, username, branch, !showAll);
         if (prsWithReviewRequested.length === 0)
             return;
-        const selectedIndex = await askUserToPickPR(prsWithReviewRequested.map(p => p.pr));
+        const selectedIndex = await askUserToPickPR(prsWithReviewRequested.map((p) => p.pr));
         if (selectedIndex === null)
             return;
         const { pr, diff } = prsWithReviewRequested[selectedIndex];
         if (pr.body) {
-            console.log(chalk.magentaBright('\n📝 PR Description:\n') + chalk.gray(pr.body));
+            console.log(chalk.magentaBright("\n📝 PR Description:\n") + chalk.white(pr.body));
+        }
+        // ✅ Ask user if they want to view diff in VS Code
+        const openInVSCode = await askOpenInVSCode();
+        if (openInVSCode) {
+            console.log(chalk.gray(`\n🧭 Opening PR #${pr.number} diff in VS Code...`));
+            await openDiffInVSCode(`${pr.title || "pull_request"}.diff`, diff);
         }
+        // === Continue AI Review ===
         const chunks = chunkDiff(diff, pr.number.toString());
-        const reviewMethod = chunks.length > 1 ? await askReviewMethod() : 'chunk';
-        let reviewComments = [];
-        if (reviewMethod === 'whole') {
-            const result = await reviewModule.run({ content: diff, filepath: 'Whole PR Diff' });
-            console.log(chalk.yellowBright("Raw AI output:\n"), result.content);
-            // Use the parsed array for selecting or displaying suggestions
-            let suggestions = result.suggestions;
-            if (suggestions && suggestions.length > 3 && /here (are|is) \d+ suggestions/i.test(suggestions[0])) {
+        const reviewMethod = chunks.length > 1 ? await askReviewMethod() : "chunk";
+        const reviewComments = [];
+        if (reviewMethod === "whole") {
+            const ioInput = {
+                query: 'review_whole_pr',
+                content: {
+                    diff,
+                    description: "Whole PR Diff"
+                }
+            };
+            const result = await reviewModule.run(ioInput);
+            const rawOutput = typeof result.data === 'string'
+                ? result.data
+                : result.content?.toString() || '1. AI review summary not available.';
+            console.log(chalk.yellowBright("Raw AI output:\n"), rawOutput);
+            let suggestions = rawOutput.split('\n').filter(Boolean); // or your old logic
+            if (suggestions.length > 3 &&
+                /here (are|is) \d+ suggestions/i.test(suggestions[0])) {
                 suggestions = suggestions.slice(1);
             }
             const finalReviewChoice = await askReviewApproval();
-            let reviewText = '';
-            // Pick the first suggestion as default if any exist
-            if (suggestions && suggestions.length > 0) {
-                reviewText = suggestions[0];
-            }
-            if (finalReviewChoice === 'approve') {
-                reviewText = 'PR approved';
-                await submitReview(pr.number, reviewText, 'APPROVE');
+            let reviewText = suggestions[0] || '';
+            if (finalReviewChoice === "approve") {
+                reviewText = "PR approved";
+                await submitReview(pr.number, reviewText, "APPROVE");
             }
-            else if (finalReviewChoice === 'reject') {
-                reviewText = 'Changes requested';
-                await submitReview(pr.number, reviewText, 'REQUEST_CHANGES');
+            else if (finalReviewChoice === "reject") {
+                reviewText = "Changes requested";
+                await submitReview(pr.number, reviewText, "REQUEST_CHANGES");
             }
-            else if (finalReviewChoice === 'custom') {
+            else if (finalReviewChoice === "custom") {
                 reviewText = await promptCustomReview();
-                await submitReview(pr.number, reviewText, 'COMMENT');
+                await submitReview(pr.number, reviewText, "COMMENT");
             }
-            else if (finalReviewChoice === 'edit') {
-                // let user edit the AI suggestion
+            else if (finalReviewChoice === "edit") {
                 reviewText = await promptEditReview(reviewText);
-                await submitReview(pr.number, reviewText, 'COMMENT');
+                await submitReview(pr.number, reviewText, "COMMENT");
             }
         }
         else {
@@ -508,27 +544,27 @@ 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 === 'cancel') {
+                if (choice === "cancel") {
                     console.log(chalk.red(`🚫 Review cancelled at chunk ${i + 1}`));
-                    return; // exit reviewPullRequestCmd early
+                    return;
                 }
-                if (choice === 'skip') {
+                if (choice === "skip") {
                     console.log(chalk.gray(`⏭️ Skipped chunk ${i + 1}`));
                     continue;
                 }
-                // 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);
+                    .flatMap((h) => h.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;
                 }
                 let commentBody = summary;
-                if (choice === 'custom') {
+                if (choice === "custom") {
                     commentBody = await promptCustomReview();
                 }
-                else if (typeof choice === 'string' && !['approve', 'reject', 'custom'].includes(choice)) {
+                else if (typeof choice === "string" &&
+                    !["approve", "reject", "custom"].includes(choice)) {
                     commentBody = choice;
                 }
                 reviewComments.push({
@@ -536,10 +572,10 @@ export async function reviewPullRequestCmd(branch = 'main', showAll = false) {
                     body: commentBody,
                     position: firstLineWithPosition.position,
                 });
-                if (choice === 'reject')
+                if (choice === "reject")
                     allApproved = false;
             }
-            console.log(chalk.blueBright('\n📝 Review Comments Preview:'));
+            console.log(chalk.blueBright("\n📝 Review Comments Preview:"));
             reviewComments.forEach((comment, idx) => {
                 console.log(`${idx + 1}. ${comment.path}:${comment.position} — ${comment.body}`);
             });
@@ -562,7 +598,6 @@ export async function reviewPullRequestCmd(branch = 'main', showAll = false) {
                     ? chalk.green("📝 Submitting inline comments with approval.")
                     : chalk.green("✔️ All chunks approved. Submitting final PR approval.")
                 : chalk.red("❌ Not all chunks were approved. Changes requested."));
-            // ✅ Only one submission, inline comments are preserved
             await submitReview(pr.number, reviewBody, reviewState, reviewComments);
         }
     }

package/dist/commands/SummaryCmd.js

@@ -1,17 +1,16 @@
 import fs from 'fs/promises';
 import path from 'path';
 import readline from 'readline';
-import { queryFiles, indexFile } from '../db/fileIndex.js';
+import { queryFiles } from '../db/fileIndex.js';
 import { summaryModule } from '../pipeline/modules/summaryModule.js';
 import { detectFileType } from '../fileRules/detectFileType.js';
-import { generateEmbedding } from '../lib/generateEmbedding.js';
 import { sanitizeQueryForFts } from '../utils/sanitizeQuery.js';
-import { getDbForRepo } from '../db/client.js';
 import { styleText } from '../utils/outputFormatter.js';
+import { indexFile } from '../daemon/runIndexingBatch.js';
 export async function summarizeFile(filepath) {
     let content = '';
     let filePathResolved;
-    // 📁 Resolve path like `scai find`
+    // 📁 Resolve file path from index or local disk
     if (filepath) {
         const sanitizedQuery = sanitizeQueryForFts(filepath);
         const matches = queryFiles(sanitizedQuery);
@@ -21,7 +20,6 @@ export async function summarizeFile(filepath) {
             console.log(`🔗 Matched file from index: ${path.relative(process.cwd(), filePathResolved)}`);
         }
         else {
-            // Fallback: check if it's a real file in CWD
             const localPath = path.resolve(process.cwd(), filepath);
             try {
                 await fs.access(localPath);
@@ -34,7 +32,7 @@ export async function summarizeFile(filepath) {
             }
         }
     }
-    // 📄 Load file content from resolved path
+    // 📄 Load file content (from path or stdin)
     if (filePathResolved) {
         const matches = queryFiles(`"${filePathResolved}"`);
         const match = matches.find(row => path.resolve(row.path) === filePathResolved);
@@ -68,24 +66,20 @@ export async function summarizeFile(filepath) {
     // 🧠 Generate summary and save
     if (content.trim()) {
         console.log('🧪 Generating summary...\n');
-        const response = await summaryModule.run({ content, filepath });
-        if (!response.summary) {
+        const response = await summaryModule.run({
+            query: `Summarize file: ${filepath ?? 'stdin'}`,
+            content,
+        });
+        const summary = response.data?.summary;
+        if (!summary) {
             console.warn('⚠️ No summary generated.');
             return;
         }
-        console.log(styleText(response.summary));
+        console.log(styleText(summary));
         if (filePathResolved) {
             const fileType = detectFileType(filePathResolved);
-            indexFile(filePathResolved, response.summary, fileType);
+            indexFile(filePathResolved, summary, fileType);
             console.log('💾 Summary saved to local database.');
-            const embedding = await generateEmbedding(response.summary);
-            if (embedding) {
-                const db = getDbForRepo();
-                db.prepare(`
-            UPDATE files SET embedding = ? WHERE path = ?
-          `).run(JSON.stringify(embedding), filePathResolved.replace(/\\/g, '/'));
-                console.log('📐 Embedding saved to database.');
-            }
         }
     }
     else {

package/dist/commands/WorkflowCmd.js

@@ -0,0 +1,41 @@
+// File: src/commands/WorkflowCmd.ts
+import chalk from 'chalk';
+import { resolveModules } from '../workflow/workflowResolver.js';
+import { runWorkflow } from '../workflow/workflowRunner.js';
+/**
+ * Runs a workflow pipeline with one or more goals.
+ * Handles both file input (-f) and stdin input (pipe).
+ */
+export async function runWorkflowCommand(goals, options) {
+    try {
+        console.log(chalk.cyan('🔁 Pipeline goals:'), goals.join(' → '));
+        // Resolve module implementations for the given goals
+        const modules = resolveModules(goals);
+        console.log(chalk.green('📋 Modules to run:'), modules.map((m) => m.name).join(' → '));
+        // Determine input source
+        const input = options.file
+            ? { filepath: options.file }
+            : { inputContent: await readStdin() };
+        // Run the workflow pipeline
+        await runWorkflow({ goals, modules, ...input });
+        console.log(chalk.green('✅ Workflow completed successfully.'));
+    }
+    catch (err) {
+        console.error(chalk.red('❌ Pipeline failed:'), err?.message ?? err);
+        process.exit(1);
+    }
+}
+/**
+ * Reads from stdin if no file path is provided.
+ */
+function readStdin() {
+    return new Promise((resolve) => {
+        if (process.stdin.isTTY)
+            return resolve('');
+        let data = '';
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', (chunk) => (data += chunk));
+        process.stdin.on('end', () => resolve(data));
+        process.stdin.resume();
+    });
+}

package/dist/commands/factory.js

@@ -0,0 +1,254 @@
+// commands/factory.ts
+import { Command } from 'commander';
+import { bootstrap } from '../modelSetup.js';
+import { runAskCommand } from './AskCmd.js';
+import { runIndexCommand } from './IndexCmd.js';
+import { resetDatabase } from './ResetDbCmd.js';
+import { suggestCommitMessage } from './CommitSuggesterCmd.js';
+import { reviewPullRequestCmd } from './ReviewCmd.js';
+import { checkGit } from './GitCmd.js';
+import { promptForToken } from '../github/token.js';
+import { validateGitHubTokenAgainstRepo } from '../github/githubAuthCheck.js';
+import { runWorkflowCommand } from './WorkflowCmd.js';
+import { handleStandaloneChangelogUpdate } from './ChangeLogUpdateCmd.js';
+import { runInteractiveSwitch } from './SwitchCmd.js';
+import { runInteractiveDelete } from './DeleteIndex.js';
+import { startDaemon, stopDaemon, restartDaemon, statusDaemon, unlockConfig, showLogs } from './DaemonCmd.js';
+import { Config } from '../config.js';
+import { fileURLToPath } from 'url';
+import { dirname, resolve } from 'path';
+import { execSync } from 'child_process';
+import { runInspectCommand } from './InspectCmd.js';
+import { runFindCommand } from './FindCmd.js';
+import { runBackupCommand } from './BackupCmd.js';
+import { updateContext } from '../context.js';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const { version } = require('../../package.json');
+export async function withContext(action) {
+    const ok = await updateContext();
+    if (!ok)
+        return; // or process.exit(1)
+    await action();
+}
+export function createProgram() {
+    const cmd = new Command('scai');
+    cmd.version(version, '-v, --version', 'output the current version');
+    // ---------------- Init commands ----------------
+    cmd
+        .command('init')
+        .description('Initialize the model and download required models')
+        .action(async () => {
+        await bootstrap();
+        console.log('✅ Model initialization completed!');
+    });
+    // ---------------- Git commands ----------------
+    const git = cmd.command('git').description('Git utilities');
+    git
+        .command('review')
+        .description('Review an open pull request using AI')
+        .option('-a, --all', 'Show all PRs requiring a review', false)
+        .action(async (opts) => {
+        await withContext(async () => {
+            await reviewPullRequestCmd('main', opts.all);
+        });
+    });
+    git
+        .command('commit')
+        .description('Suggest a commit message from staged changes')
+        .option('-l, --changelog', 'Generate and optionally stage a changelog entry')
+        .action(async (opts) => {
+        await withContext(async () => {
+            await suggestCommitMessage(opts);
+        });
+    });
+    git
+        .command('check')
+        .description('Check Git working directory and branch status')
+        .action(async () => {
+        await withContext(async () => { checkGit(); });
+    });
+    // ---------------- Auth commands ----------------
+    const auth = cmd.command('auth').description('GitHub authentication commands');
+    auth
+        .command('check')
+        .description('Check if GitHub authentication is valid')
+        .action(async () => {
+        await withContext(async () => {
+            try {
+                const token = Config.getGitHubToken();
+                if (!token)
+                    return console.log('❌ GitHub token not found.');
+                const result = await validateGitHubTokenAgainstRepo();
+                console.log(result);
+            }
+            catch (err) {
+                console.error(err instanceof Error ? err.message : err);
+            }
+        });
+    });
+    auth
+        .command('reset')
+        .description('Reset GitHub authentication credentials')
+        .action(async () => {
+        await withContext(async () => {
+            Config.setGitHubToken('');
+            console.log('✅ GitHub token reset.');
+        });
+    });
+    auth
+        .command('set')
+        .description('Set GitHub Personal Access Token')
+        .action(async () => {
+        await withContext(async () => {
+            const token = (await promptForToken()).trim();
+            Config.setGitHubToken(token);
+            console.log('🔑 GitHub token set.');
+        });
+    });
+    // ---------------- Workflow ----------------
+    const workflow = cmd.command('workflow').description('Run or manage module pipelines');
+    workflow
+        .command('run <goals...>')
+        .description('Run one or more modules as a pipeline')
+        .option('-f, --file <filepath>', 'File to process (omit to read from stdin)')
+        .action(async (goals, options) => {
+        await withContext(async () => {
+            await runWorkflowCommand(goals, options);
+        });
+    })
+        .on('--help', () => {
+        console.log('\nExamples:');
+        console.log('  $ scai workflow run comments tests -f path/to/myfile.ts');
+        console.log('  $ cat file.ts | scai workflow run comments tests > file.test.ts\n');
+        console.log('Available modules: summary, comments, tests');
+    });
+    // ---------------- Gen / Changelog ----------------
+    const gen = cmd.command('gen').description('Generate code-related output');
+    gen
+        .command('changelog')
+        .description('Update or create CHANGELOG.md')
+        .action(async () => {
+        await withContext(async () => { await handleStandaloneChangelogUpdate(); });
+    });
+    // ---------------- Config ----------------
+    const config = cmd.command('config').description('Manage SCAI configuration');
+    config
+        .command('set-model <model>')
+        .description('Set the model to use')
+        .option('-g, --global', 'Set globally instead of repo')
+        .action(async (model, opts) => {
+        await withContext(async () => {
+            Config.setModel(model, opts.global ? 'global' : 'repo');
+            Config.show();
+        });
+    });
+    config
+        .command('set-lang <lang>')
+        .description('Set programming language')
+        .action(async (lang) => {
+        await withContext(async () => { Config.setLanguage(lang); Config.show(); });
+    });
+    config
+        .command('show')
+        .option('--raw', 'Show raw config')
+        .description('Display current configuration')
+        .action(async (opts) => {
+        await withContext(async () => {
+            if (opts.raw)
+                console.log(JSON.stringify(Config.getRaw(), null, 2));
+            else
+                Config.show();
+        });
+    });
+    // 💤 Set daemon sleep intervals
+    config
+        .command('set-daemon')
+        .description('Set daemon sleep intervals (ms between runs)')
+        .option('--sleep <ms>', 'Sleep time in milliseconds between batches')
+        .option('--idle <ms>', 'Sleep time in milliseconds when idle')
+        .action(async (options) => {
+        await withContext(async () => {
+            const updates = {};
+            if (options.sleep)
+                updates.sleepMs = parseInt(options.sleep, 10);
+            if (options.idle)
+                updates.idleSleepMs = parseInt(options.idle, 10);
+            if (!Object.keys(updates).length) {
+                console.log('⚠️  No options provided. Use --sleep or --idle.');
+                return;
+            }
+            Config.setDaemonConfig(updates);
+            const current = Config.getDaemonConfig();
+            console.log(`🕒 Updated daemon settings:\n   sleepMs=${current.sleepMs}ms\n   idleSleepMs=${current.idleSleepMs}ms`);
+        });
+    });
+    // ---------------- Index ----------------
+    const index = cmd.command('index').description('Index operations');
+    index
+        .command('start')
+        .description('Index supported files')
+        .action(async () => await withContext(runIndexCommand));
+    index
+        .command('set [dir]')
+        .description('Set index directory')
+        .action(async (dir = process.cwd()) => {
+        await Config.setIndexDir(dir);
+        Config.show();
+    });
+    index
+        .command('list')
+        .description('List all indexed repositories')
+        .action(async () => await withContext(async () => { await Config.printAllRepos(); }));
+    index
+        .command('switch')
+        .description('Switch active repository interactively')
+        .action(async () => await withContext(runInteractiveSwitch));
+    index
+        .command('delete')
+        .description('Delete repository interactively')
+        .action(async () => await withContext(runInteractiveDelete));
+    // ---------------- DB ----------------
+    const db = cmd.command('db').description('Database operations');
+    db
+        .command('check')
+        .description('Run dbcheck script')
+        .action(async () => {
+        await withContext(async () => {
+            const __filename = fileURLToPath(import.meta.url);
+            const __dirname = dirname(__filename);
+            const scriptPath = resolve(__dirname, '../..', 'dist/scripts', 'dbcheck.js');
+            try {
+                execSync(`node "${scriptPath}"`, { stdio: 'inherit' });
+            }
+            catch (err) {
+                console.error('❌ DB check failed:', err instanceof Error ? err.message : err);
+            }
+        });
+    });
+    db
+        .command('reset')
+        .description('Reset SQLite database')
+        .action(async () => await withContext(resetDatabase));
+    db
+        .command('inspect <filepath>')
+        .description('Inspect a file in the index')
+        .action(async (filepath) => await withContext(() => runInspectCommand(filepath)));
+    // ---------------- Daemon ----------------
+    const daemon = cmd.command('daemon').description('Daemon management');
+    daemon.command('start').description('Start daemon').action(async () => withContext(startDaemon));
+    daemon.command('stop').description('Stop daemon').action(async () => withContext(stopDaemon));
+    daemon.command('restart').description('Restart daemon').action(async () => withContext(restartDaemon));
+    daemon.command('status').description('Daemon status').action(async () => withContext(statusDaemon));
+    daemon.command('unlock').description('Force unlock').action(async () => withContext(unlockConfig));
+    daemon.command('logs').option('-n, --lines <n>', 'Last N log lines', '20')
+        .description('Show daemon logs')
+        .action(async (opts) => withContext(() => showLogs(parseInt(opts.lines, 10))));
+    // ---------------- Backup / Find / Ask ----------------
+    cmd.command('backup').description('Backup .scai folder').action(async () => await withContext(runBackupCommand));
+    cmd.command('find <query>').description('Search indexed files').action(async (q) => await withContext(() => runFindCommand(q)));
+    cmd.command('ask [question...]').description('Ask a question').action(async (parts) => {
+        await withContext(async () => { await runAskCommand(parts?.join(' ')); });
+    });
+    return cmd;
+}