korext 0.8.2 → 0.9.0

package/bin/korext.js

@@ -1184,5 +1184,125 @@ policyCmd
 
 // ─── END POLICY COMMANDS ──────────────────────────────────────────────────
 
-program.parse(process.argv);
+// ─── WATCH COMMAND (Initiative #5 - CLI Watch Mode) ──────────────────────
+
+program
+  .command('watch [dir]')
+  .description('Continuously enforce policies on file changes (live development mode)')
+  .option('-p, --pack <packId>', 'Policy Pack ID to enforce', 'web')
+  .option('--offline', 'Force local-only analysis using cached rule definitions', false)
+  .action(async (dirArg, options) => {
+    const dir = path.resolve(dirArg || '.');
+    const pack = options.pack;
+    const forceOffline = options.offline;
+
+    console.log(`\n${chalk.bold.hex('#F27D26')('\u25b2 KOREXT WATCH MODE')} v${version}`);
+    console.log(chalk.dim('======================================='));
+    console.log(`  Directory: ${chalk.cyan(dir)}`);
+    console.log(`  Pack:      ${chalk.cyan(pack)}`);
+    console.log(`  Mode:      ${forceOffline ? chalk.yellow('Offline (local engine)') : chalk.green('Online (server + local fallback)')}`);
+    console.log(chalk.dim('\n  Watching for file changes... Press Ctrl+C to stop.\n'));
+
+    const token = getToken();
+    let localDefinitions = getRuleDefinitionsCache();
+
+    if (forceOffline && !localDefinitions) {
+      console.error(chalk.red('Offline mode requires cached rule definitions.'));
+      console.error(chalk.dim(`  Run: ${chalk.green('korext rules sync')} first while online.`));
+      process.exit(1);
+    }
+
+    if (!forceOffline && !localDefinitions) {
+      try {
+        localDefinitions = await fetchAndCacheRules();
+        console.log(chalk.green(`  Synced ${localDefinitions.ruleCount} rules for local fallback.\n`));
+      } catch { /* will use server */ }
+    }
+
+    const SUPPORTED_EXTS = new Set(['.ts', '.tsx', '.js', '.jsx', '.py', '.go', '.java', '.rs']);
+    const IGNORE_DIRS = new Set(['node_modules', '.git', 'dist', 'build', '.next', '.korext']);
+    const debounceTimers = new Map();
+    const DEBOUNCE_MS = 800;
+    let totalViolations = 0;
+    let filesChecked = 0;
+
+    async function analyzeWatchedFile(filePath) {
+      const displayPath = path.relative(dir, filePath);
+      const ext = path.extname(filePath);
+      if (!SUPPORTED_EXTS.has(ext)) return;
+
+      let fileContent;
+      try { fileContent = fs.readFileSync(filePath, 'utf-8'); } catch { return; }
+      if (fileContent.length > 500000) return;
+
+      const language = getLanguageFromExt(ext);
+      let violations = [];
+      filesChecked++;
+
+      if (forceOffline && localDefinitions) {
+        violations = analyzeLocally(fileContent, pack, localDefinitions);
+      } else {
+        try {
+          const res = await fetch(`${API_URL}/api/ide/analyze`, {
+            method: 'POST',
+            headers: {
+              'Content-Type': 'application/json',
+              ...(token && { 'Authorization': `Bearer ${token}` })
+            },
+            body: JSON.stringify({ fileContent, language, fileName: filePath, packId: pack, requestSignature: false })
+          });
+          if (res.ok) {
+            const result = await res.json();
+            violations = result.violations || [];
+          } else { throw new Error(`HTTP ${res.status}`); }
+        } catch {
+          if (localDefinitions) violations = analyzeLocally(fileContent, pack, localDefinitions);
+        }
+      }
+
+      const now = new Date().toLocaleTimeString();
+      if (violations.length > 0) {
+        totalViolations += violations.length;
+        console.log(`\n${chalk.dim(now)} ${chalk.bold.underline(displayPath)}`);
+        for (const v of violations) {
+          let tag = chalk.blue('LOW');
+          if (v.severity === 'critical') tag = chalk.bgRed.white.bold(' CRITICAL ');
+          else if (v.severity === 'high') tag = chalk.red.bold('HIGH');
+          else if (v.severity === 'medium') tag = chalk.yellow.bold('MED');
+          console.log(`  ${chalk.dim(v.line + ':')}  ${tag}  ${v.ruleName || v.explanation}`);
+        }
+      } else {
+        console.log(`${chalk.dim(now)} ${chalk.green('\u2713')} ${displayPath}`);
+      }
+    }
 
+    try {
+      fs.watch(dir, { recursive: true }, (eventType, filename) => {
+        if (!filename) return;
+        const parts = filename.split(path.sep);
+        if (parts.some(p => IGNORE_DIRS.has(p))) return;
+        if (!SUPPORTED_EXTS.has(path.extname(filename))) return;
+
+        const fullPath = path.join(dir, filename);
+        if (debounceTimers.has(fullPath)) clearTimeout(debounceTimers.get(fullPath));
+        debounceTimers.set(fullPath, setTimeout(() => {
+          debounceTimers.delete(fullPath);
+          if (fs.existsSync(fullPath)) analyzeWatchedFile(fullPath);
+        }, DEBOUNCE_MS));
+      });
+    } catch (e) {
+      console.error(chalk.red(`Failed to watch ${dir}: ${e.message}`));
+      process.exit(1);
+    }
+
+    process.on('SIGINT', () => {
+      console.log(`\n\n${chalk.bold.hex('#F27D26')('\u25b2 KOREXT WATCH SUMMARY')}`);
+      console.log(chalk.dim('======================================='));
+      console.log(`  Files checked:     ${chalk.cyan(filesChecked)}`);
+      console.log(`  Total violations:  ${totalViolations > 0 ? chalk.red(totalViolations) : chalk.green('0')}`);
+      console.log(chalk.dim('\nGoodbye.\n'));
+      process.exit(0);
+    });
+  });
+
+program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "korext",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "description": "Korext Command Line Interface",
   "type": "module",
   "main": "bin/korext.js",