@code-rag/cli 0.1.0

package/dist/commands/viewer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.test.js","sourceRoot":"","sources":["../../src/commands/viewer.test.ts"],"names":[],"mappings":"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"}

package/dist/commands/watch-cmd.d.ts

@@ -0,0 +1,8 @@
+import { Command } from 'commander';
+/**
+ * Register the `coderag watch` CLI command.
+ *
+ * Starts a file watcher that monitors the project directory for changes
+ * and triggers incremental re-indexing on each debounced batch.
+ */
+export declare function registerWatchCommand(program: Command): void;

package/dist/commands/watch-cmd.js

@@ -0,0 +1,152 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { resolve, sep } from 'node:path';
+import { spawn } from 'node:child_process';
+import { loadConfig, createIgnoreFilter, FileWatcher, } from '@code-rag/core';
+/**
+ * Register the `coderag watch` CLI command.
+ *
+ * Starts a file watcher that monitors the project directory for changes
+ * and triggers incremental re-indexing on each debounced batch.
+ */
+export function registerWatchCommand(program) {
+    program
+        .command('watch')
+        .description('Watch the codebase for changes and trigger incremental re-indexing')
+        .option('--debounce <ms>', 'Debounce window in milliseconds', '2000')
+        .action(async (options) => {
+        const debounceMs = parseInt(options.debounce, 10);
+        if (isNaN(debounceMs) || debounceMs < 0) {
+            // eslint-disable-next-line no-console
+            console.error(chalk.red('Invalid debounce value. Must be a non-negative integer.'));
+            process.exit(1);
+        }
+        const spinner = ora('Loading configuration...').start();
+        try {
+            const rootDir = process.cwd();
+            // Load config
+            const configResult = await loadConfig(rootDir);
+            if (configResult.isErr()) {
+                spinner.fail(configResult.error.message);
+                // eslint-disable-next-line no-console
+                console.error(chalk.red('Run "coderag init" first to create a configuration file.'));
+                process.exit(1);
+            }
+            const config = configResult.value;
+            const storagePath = resolve(rootDir, config.storage.path);
+            // Prevent path traversal outside project root
+            if (!storagePath.startsWith(resolve(rootDir) + sep) && storagePath !== resolve(rootDir)) {
+                spinner.fail('Storage path escapes project root');
+                process.exit(1);
+            }
+            // Create ignore filter
+            const ignoreFilter = createIgnoreFilter(rootDir);
+            // Create and start file watcher
+            const watcher = new FileWatcher({
+                rootDir,
+                ignoreFilter,
+                debounceMs,
+            });
+            let isIndexing = false;
+            let indexCount = 0;
+            watcher.on('change', (changedPaths) => {
+                if (isIndexing) {
+                    // eslint-disable-next-line no-console
+                    console.log(chalk.yellow(`  Skipping batch (${changedPaths.length} files) — indexing already in progress`));
+                    return;
+                }
+                isIndexing = true;
+                indexCount++;
+                const batchNum = indexCount;
+                // eslint-disable-next-line no-console
+                console.log('');
+                // eslint-disable-next-line no-console
+                console.log(chalk.bold(`[Batch ${batchNum}] ${changedPaths.length} file(s) changed:`));
+                for (const filePath of changedPaths.slice(0, 10)) {
+                    // eslint-disable-next-line no-console
+                    console.log(`  ${chalk.gray('→')} ${filePath}`);
+                }
+                if (changedPaths.length > 10) {
+                    // eslint-disable-next-line no-console
+                    console.log(`  ${chalk.gray(`… and ${changedPaths.length - 10} more`)}`);
+                }
+                // eslint-disable-next-line no-console
+                console.log(chalk.cyan('  Running incremental index...'));
+                const startTime = Date.now();
+                const child = spawn(process.execPath, [process.argv[1], 'index'], {
+                    cwd: rootDir,
+                    stdio: ['ignore', 'pipe', 'pipe'],
+                });
+                child.stdout.on('data', (data) => {
+                    const lines = data.toString().trimEnd().split('\n');
+                    for (const line of lines) {
+                        // eslint-disable-next-line no-console
+                        console.log(`  ${chalk.gray('│')} ${line}`);
+                    }
+                });
+                child.stderr.on('data', (data) => {
+                    const lines = data.toString().trimEnd().split('\n');
+                    for (const line of lines) {
+                        // eslint-disable-next-line no-console
+                        console.log(`  ${chalk.gray('│')} ${chalk.yellow(line)}`);
+                    }
+                });
+                child.on('close', (code) => {
+                    const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+                    if (code === 0) {
+                        // eslint-disable-next-line no-console
+                        console.log(chalk.green(`  Batch ${batchNum} complete (${elapsed}s)`));
+                    }
+                    else {
+                        // eslint-disable-next-line no-console
+                        console.log(chalk.red(`  Batch ${batchNum} failed with exit code ${code ?? 'unknown'} (${elapsed}s)`));
+                    }
+                    isIndexing = false;
+                });
+                child.on('error', (err) => {
+                    // eslint-disable-next-line no-console
+                    console.log(chalk.red(`  Batch ${batchNum} spawn error: ${err.message}`));
+                    isIndexing = false;
+                });
+            });
+            watcher.on('error', (error) => {
+                // eslint-disable-next-line no-console
+                console.error(chalk.red(`Watcher error: ${error.message}`));
+            });
+            spinner.succeed('Configuration loaded');
+            // eslint-disable-next-line no-console
+            console.log('');
+            // eslint-disable-next-line no-console
+            console.log(chalk.bold('CodeRAG File Watcher'));
+            // eslint-disable-next-line no-console
+            console.log(`  Root:     ${chalk.cyan(rootDir)}`);
+            // eslint-disable-next-line no-console
+            console.log(`  Debounce: ${chalk.cyan(debounceMs + 'ms')}`);
+            // eslint-disable-next-line no-console
+            console.log(`  Storage:  ${chalk.cyan(storagePath)}`);
+            // eslint-disable-next-line no-console
+            console.log('');
+            // eslint-disable-next-line no-console
+            console.log(chalk.gray('Watching for file changes... (press Ctrl+C to stop)'));
+            await watcher.start();
+            // Handle graceful shutdown
+            const shutdown = async () => {
+                // eslint-disable-next-line no-console
+                console.log('');
+                // eslint-disable-next-line no-console
+                console.log(chalk.yellow('Stopping watcher...'));
+                await watcher.stop();
+                // eslint-disable-next-line no-console
+                console.log(chalk.green(`Watcher stopped. Processed ${indexCount} batch(es).`));
+                process.exit(0);
+            };
+            process.on('SIGINT', () => void shutdown());
+            process.on('SIGTERM', () => void shutdown());
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            spinner.fail(`Watch failed: ${message}`);
+            process.exit(1);
+        }
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { registerInitCommand } from './commands/init.js';
+import { registerIndexCommand } from './commands/index-cmd.js';
+import { registerSearchCommand } from './commands/search.js';
+import { registerServeCommand } from './commands/serve.js';
+import { registerStatusCommand } from './commands/status.js';
+import { registerViewerCommand } from './commands/viewer.js';
+import { registerWatchCommand } from './commands/watch-cmd.js';
+import { registerHooksCommand } from './commands/hooks-cmd.js';
+const program = new Command();
+program
+    .name('coderag')
+    .description('CodeRAG — intelligent codebase context engine for AI coding agents')
+    .version('0.1.0');
+registerInitCommand(program);
+registerIndexCommand(program);
+registerSearchCommand(program);
+registerServeCommand(program);
+registerStatusCommand(program);
+registerViewerCommand(program);
+registerWatchCommand(program);
+registerHooksCommand(program);
+program.parse();

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAC9B,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,oEAAoE,CAAC;KACjF,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAE/B,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@code-rag/cli",
+  "version": "0.1.0",
+  "description": "CLI tool for CodeRAG — init, index, search, serve, and status commands for codebase context engine",
+  "type": "module",
+  "license": "MIT",
+  "author": "CodeRAG Contributors",
+  "homepage": "https://dev.azure.com/momc-pl/CodeRAG/_git/CodeRAG",
+  "bugs": {
+    "url": "https://dev.azure.com/momc-pl/CodeRAG/_git/CodeRAG/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://dev.azure.com/momc-pl/CodeRAG/_git/CodeRAG",
+    "directory": "packages/cli"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "coderag",
+    "cli",
+    "code-search",
+    "ai-coding",
+    "rag",
+    "embeddings",
+    "developer-tools"
+  ],
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "bin": {
+    "coderag": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@code-rag/api-server": "workspace:*",
+    "@code-rag/core": "workspace:*",
+    "@code-rag/mcp-server": "workspace:*",
+    "@inquirer/prompts": "^8.3.0",
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "ora": "^8.2.0",
+    "yaml": "^2.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.4",
+    "@vitest/coverage-v8": "^3.0.5",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
+  }
+}