Add --path option to TypeScript CLI layer

- Add --path/-p option to Commander CLI in npx/src/index.ts
- Make --url and --path mutually exclusive with validation
- Update ReviewOptions interface to support both modes
- Skip GitHub token requirement for local path mode
- Pass --path to Python CLI when provided instead of --url
- All three files (index.ts, cli.ts, python-runner.ts) updated consistently

Agent-Id: agent-878b18ab-2ad7-486a-9f3a-56e26a705499

Author: sng-asyncfunc

npx/src/cli.ts

@@ -15,7 +15,8 @@ import {
 } from './python-runner.js';
 
 export interface ReviewOptions {
-    url: string;
+    url?: string;
+    path?: string;
     question?: string;
     output: string;
     quiet?: boolean;
@@ -26,19 +27,23 @@ export interface ReviewOptions {
 }
 
 export async function runReview(options: ReviewOptions): Promise<void> {
-    const { url, question, output, quiet = false, model, api, githubToken, expert = false } = options;
+    const { url, path, question, output, quiet = false, model, api, githubToken, expert = false } = options;
 
     try {
 
         // 4. Get API key
         const apiKey = await getApiKey(api);
 
-        // 5. Get GitHub token (required for code search API)
-        const ghToken = await getGitHubToken(githubToken, true);
+        // 5. Get GitHub token only if using URL mode (not required for local path mode)
+        let ghToken: string | undefined;
+        if (url) {
+            ghToken = await getGitHubToken(githubToken, true);
+        }
 
         // 6. Run the review
         if (!quiet) {
-            console.log(chalk.cyan(`\n 🔍 Reviewing: ${url}`));
+            const target = url || path;
+            console.log(chalk.cyan(`\n 🔍 Reviewing: ${target}`));
             if (expert) {
                 console.log(chalk.cyan(`   Mode: Expert Code Review (SOLID, Security, Code Quality)\n`));
             } else if (question) {
@@ -48,6 +53,7 @@ export async function runReview(options: ReviewOptions): Promise<void> {
 
         const result = await runPythonReview({
             url,
+            path,
             question,
             output,
             quiet,

npx/src/index.ts

@@ -16,8 +16,9 @@ program
 
 program
     .command('review')
-    .description('Review a GitHub PR or Issue')
-    .requiredOption('-u, --url <url>', 'GitHub PR or Issue URL')
+    .description('Review a GitHub PR/Issue or local directory')
+    .option('-u, --url <url>', 'GitHub PR or Issue URL')
+    .option('-p, --path <path>', 'Local directory path to review')
     .option('-q, --question <question>', 'Question to ask about the PR/Issue (optional with --expert)')
     .option('--expert', 'Run expert code review (SOLID, Security, Performance, Code Quality)')
     .option('-o, --output <format>', 'Output format: text, markdown, json', 'text')
@@ -26,6 +27,15 @@ program
     .option('--api <key>', 'Gemini API key (defaults to GEMINI_API_KEY env var)')
     .option('--github-token <token>', 'GitHub token for private repos (defaults to GITHUB_TOKEN env var)')
     .action(async (options) => {
+        // Validate mutual exclusion: exactly one of --url or --path must be provided
+        if (!options.url && !options.path) {
+            console.error('Error: Either --url or --path must be provided');
+            process.exit(1);
+        }
+        if (options.url && options.path) {
+            console.error('Error: --url and --path are mutually exclusive');
+            process.exit(1);
+        }
         await runReview(options);
     });
 

npx/src/python-runner.ts

@@ -251,7 +251,8 @@ export async function installAsyncReview(systemPython: string, quiet: boolean =
 }
 
 export interface RunOptions {
-    url: string;
+    url?: string;
+    path?: string;
     question?: string;
     output: string;
     quiet: boolean;
@@ -282,10 +283,17 @@ export async function runPythonReview(options: RunOptions): Promise<string> {
         const args = [
             '-m', 'cli.main',
             'review',
-            '--url', options.url,
-            '--output', options.output,
         ];
 
+        // Add either --url or --path (mutually exclusive)
+        if (options.url) {
+            args.push('--url', options.url);
+        } else if (options.path) {
+            args.push('--path', options.path);
+        }
+
+        args.push('--output', options.output);
+
         // Add question if provided
         if (options.question) {
             args.push('-q', options.question);