pika-review 2.0.1 → 2.1.0

package/README.md

@@ -1,22 +1,27 @@
 # Pika Review 🦊
-### Enterprise-grade AI Architectural Sentinel
 
-Pika Review is a high-performance CLI tool designed to perform surgical code reviews using AI. It focuses on deep architectural debt, security vulnerabilities, and UI/UX anomalies that traditional linters miss.
+### Enterprise-grade AI Architectural Sentinel & Compliance Engine
+
+Pika Review is a high-performance CLI tool designed to perform surgical code reviews using AI. It focuses on deep architectural debt, security vulnerabilities, and project-specific compliance that traditional linters miss.
 
 **GitHub**: [HackX-IN/pika-review](https://github.com/HackX-IN/pika-review)
 
 ---
 
 ## 🚀 Key Features
-- **Provider Agnostic**: Seamlessly works with Cloudflare Workers AI, OpenAI, Grok, or local LLMs via OpenAI-compatible endpoints.
-- **Mixture of Experts (MoE) Reasoning**: Leverages advanced LLMs for deep structural analysis.
-- **Polyglot Heuristics**: Idiom-aware reviews across Python, JS/TS, Go, Rust, and React.
-- **Interactive UI**: Claude-inspired terminal experience with real-time progress and multi-select discovery.
-- **Enterprise-Ready**: Built-in token safety, JSON self-healing, and CI/CD integration.
+
+- **🧠 Architecture Rules Engine**: Enforce project-specific standards via `.pika-rules.md`.
+- **📊 Health Dashboard**: Track architectural health trends over time with `pika-review stats`.
+- **🎨 Premium Interactive Reports**: Immersive, dark-mode HTML reports for deep triage.
+- **🔍 Smart Context Scanning**: Uses `-U10` context windows for higher AI reasoning accuracy.
+- **🛡️ "Pika-Ignore" support**: Suppress specific lines using `// pika-ignore` comments.
+- **⚡ Parallel Orchestration**: Scans multiple files concurrently with `p-limit`.
+- **🌍 Provider Agnostic**: Works with OpenAI, Claude, Grok, or any OpenAI-compatible endpoint.
 
 ---
 
 ## 📦 Installation
+
 ```bash
 # Via Bun (Recommended)
 bun add -g pika-review
@@ -26,53 +31,69 @@ npm install -g pika-review
 ```
 
 ## 🛠️ Setup
+
 1. Initialize your configuration:
    ```bash
    pika-review init
    ```
-2. Open `~/.pika-review.yaml` and add your Cloudflare credentials:
+2. Configure your AI provider in `~/.pika-review.yaml`:
    ```yaml
    ai:
-     accountId: "your-account-id"
-     apiKey: "your-scoped-api-token"
+     apiKey: "your-api-token"
+     model: "gpt-4o" # or your preferred model
+     baseURL: "https://api.openai.com/v1"
    ```
 
-### 🌍 Custom AI Providers (OpenAI, Grok, etc.)
-Pika Review works with any OpenAI-compatible API. To use a different provider, simply override the `baseURL` and `model` in your config:
+---
 
-```yaml
-ai:
-  apiKey: "your-openai-key"
-  model: "gpt-4o"
-  baseURL: "https://api.openai.com/v1"
-```
+## 🏗️ Enterprise Features
 
-## 🔍 Usage
-Scan staged git changes:
-```bash
-pika-review scan
-```
+### 1. Architecture Rules Engine
 
-Scan specific files:
-```bash
-pika-review scan src/index.ts src/utils/token.ts
+Create a `.pika-rules.md` file in your repository root to guide the AI with project-specific context:
+
+```markdown
+# Architectural Rules
+
+- Use Functional Components with Hooks, never Class Components.
+- All service calls must go through `src/api/client.ts`.
+- Database queries are restricted to the Repository layer.
 ```
 
-Scan unstaged changes:
-```bash
-pika-review scan --unstaged
+### 2. Pika-Ignore
+
+Suppress false positives or acknowledged risks directly in your code:
+
+```typescript
+const secret = "12345"; // pika-ignore (intentional for testing)
 ```
 
-### CI/CD Mode
-Use the `--ci` flag in GitHub Actions or other pipelines to fail if Critical or High severity issues are found:
+### 3. Health Stats
+
+Monitor your codebase's architectural debt over time:
+
 ```bash
-pika-review scan --ci
+pika-review stats
 ```
 
 ---
 
+## 🔍 Usage
+
+| Command                 | Description                           |
+| :---------------------- | :------------------------------------ |
+| `pika-review scan`      | Scan staged git changes (Default)     |
+| `pika-review scan -i`   | Interactive file selection mode       |
+| `pika-review view`      | Open the latest interactive report    |
+| `pika-review stats`     | View architectural health dashboard   |
+| `pika-review scan --ci` | Fail pipeline on Critical/High issues |
+
+---
+
 ## 🛡️ Privacy & Security
-Pika Review uses your local git diffs and sends them directly to your Cloudflare Workers AI instance. No code is stored by Pika Review.
+
+Pika Review processes your local git diffs and transmits them directly to your configured AI provider via SSL. No code is stored or cached by the Pika Review engine.
 
 ## 📄 License
+
 MIT © Pika Review Contributors

package/dist/cmd/scan.js

@@ -10,23 +10,25 @@ export async function scanAction(files, options) {
     const target = options.unstaged ? "unstaged" : "staged";
     const isCI = !!options.ci;
     let targets = files.length > 0 ? files : undefined;
-    // Interactive Discovery: If no files provided and no git changes, ask the user
-    if (!targets && !isCI) {
-        const gitChanges = getDiffFiles(target);
-        if (gitChanges.length === 0) {
-            logger.info("No git changes detected. Entering interactive selection mode...");
-            const allFiles = listProjectFiles();
-            if (allFiles.length > 0) {
-                const selection = await prompts({
-                    type: "multiselect",
-                    name: "files",
-                    message: "Select files to analyze (Space to select, Enter to confirm):",
-                    choices: allFiles.map(f => ({ title: f, value: f })),
-                    hint: "- Space to select. Return to submit"
-                });
-                if (selection.files && selection.files.length > 0) {
-                    targets = selection.files;
-                }
+    // Interactive Discovery: If requested or if no files provided and no git changes
+    if (!isCI && (options.interactive || (!targets && getDiffFiles(target).length === 0))) {
+        logger.info("Entering interactive selection mode...");
+        const allFiles = listProjectFiles();
+        if (allFiles.length > 0) {
+            const selection = await prompts({
+                type: "multiselect",
+                name: "files",
+                message: "Select files to analyze (Space to select, Enter to confirm):",
+                choices: allFiles.map(f => ({ title: f, value: f })),
+                hint: "- Space to select. Return to submit",
+                instructions: false
+            });
+            if (selection.files && selection.files.length > 0) {
+                targets = selection.files;
+            }
+            else if (options.interactive) {
+                logger.warn("No files selected. Exiting.");
+                return;
             }
         }
     }

package/dist/cmd/stats.js

@@ -0,0 +1,55 @@
+import fs from "fs";
+import path from "path";
+import chalk from "chalk";
+import { logger } from "../utils/logger.js";
+/**
+ * Stats Action: Displays architectural health trends.
+ */
+export async function statsAction() {
+    const historyPath = path.join(process.cwd(), ".pika-reports", "history.json");
+    if (!fs.existsSync(historyPath)) {
+        logger.error("No scan history found. Run some scans first!");
+        return;
+    }
+    try {
+        const history = JSON.parse(fs.readFileSync(historyPath, "utf-8"));
+        if (history.length === 0) {
+            logger.error("Scan history is empty.");
+            return;
+        }
+        console.log(`\n${chalk.bgBlue.white.bold(" PIKA ARCHITECTURAL HEALTH DASHBOARD ")}\n`);
+        console.log(`${chalk.dim("Tracking trends across the last " + history.length + " scans")}\n`);
+        // Table Header
+        console.log(chalk.bold("Date                Files   Issues   Critical   High   Medium   Low"));
+        console.log(chalk.dim("-".repeat(75)));
+        history.slice(-10).forEach((run) => {
+            const date = new Date(run.timestamp).toLocaleString().padEnd(20);
+            const files = String(run.totalFiles).padEnd(8);
+            const issues = String(run.totalIssues).padEnd(9);
+            const crit = chalk.red(String(run.severityCounts.Critical || 0).padEnd(11));
+            const high = chalk.hex("#fb923c")(String(run.severityCounts.High || 0).padEnd(7));
+            const med = chalk.yellow(String(run.severityCounts.Medium || 0).padEnd(9));
+            const low = chalk.green(String(run.severityCounts.Low || 0).padEnd(6));
+            console.log(`${date}${files}${issues}${crit}${high}${med}${low}`);
+        });
+        // Summary Insights
+        const latest = history[history.length - 1];
+        const previous = history.length > 1 ? history[history.length - 2] : null;
+        console.log(`\n${chalk.bold("Latest Insight:")}`);
+        if (previous) {
+            const diff = latest.totalIssues - previous.totalIssues;
+            const direction = diff > 0 ? chalk.red("increased") : diff < 0 ? chalk.green("decreased") : "remained stable";
+            console.log(`- Issue count ${direction} by ${Math.abs(diff)} since the last scan.`);
+        }
+        const critTotal = latest.severityCounts.Critical || 0;
+        if (critTotal > 0) {
+            console.log(`- ${chalk.red("🚨 Critical Action Required:")} ${critTotal} architectural risks detected.`);
+        }
+        else {
+            console.log(`- ${chalk.green("✅ Zero Critical Issues:")} Maintain this standard!`);
+        }
+    }
+    catch (e) {
+        logger.error("Failed to parse history data.");
+    }
+}

package/dist/cmd/view.js

@@ -0,0 +1,55 @@
+import fs from "fs";
+import path from "path";
+import { execSync } from "child_process";
+import chalk from "chalk";
+import { logger } from "../utils/logger.js";
+/**
+ * View Action: Finds and opens the latest HTML report.
+ */
+export async function viewAction() {
+    const rootReportDir = path.join(process.cwd(), ".pika-reports");
+    if (!fs.existsSync(rootReportDir)) {
+        logger.error("No reports found. Run a scan first!");
+        return;
+    }
+    // Get project directories (e.g. .pika-reports/pika-review/)
+    const projectDirs = fs.readdirSync(rootReportDir, { withFileTypes: true })
+        .filter(dirent => dirent.isDirectory())
+        .map(dirent => dirent.name);
+    if (projectDirs.length === 0) {
+        logger.error("No reports found. Run a scan first!");
+        return;
+    }
+    // Find all report.html files across all projects and timestamps
+    const allReports = [];
+    for (const project of projectDirs) {
+        const projectPath = path.join(rootReportDir, project);
+        const timestamps = fs.readdirSync(projectPath, { withFileTypes: true })
+            .filter(dirent => dirent.isDirectory())
+            .map(dirent => dirent.name);
+        for (const ts of timestamps) {
+            const reportPath = path.join(projectPath, ts, "report.html");
+            if (fs.existsSync(reportPath)) {
+                allReports.push({
+                    path: reportPath,
+                    mtime: fs.statSync(reportPath).mtimeMs
+                });
+            }
+        }
+    }
+    if (allReports.length === 0) {
+        logger.error("No HTML reports found. Run a scan first!");
+        return;
+    }
+    // Sort by modification time (latest first)
+    allReports.sort((a, b) => b.mtime - a.mtime);
+    const latestReport = allReports[0].path;
+    logger.info(`Opening latest report: ${chalk.cyan(latestReport)}`);
+    try {
+        const command = process.platform === "win32" ? "start" : process.platform === "darwin" ? "open" : "xdg-open";
+        execSync(`${command} "${latestReport}"`);
+    }
+    catch (e) {
+        logger.error("Failed to open the report automatically. Please open it manually.");
+    }
+}

package/dist/core/ai.js

@@ -2,6 +2,8 @@ import OpenAI from "openai";
 import { ReviewSchema } from "../utils/schema.js";
 import { getConfig } from "../utils/config.js";
 import { logger } from "../utils/logger.js";
+import path from "path";
+import fs from "fs";
 /**
  * Structural Extractor: Isolate the JSON object from AI chatter.
  * MoE (Mixture of Experts) models often add preamble or postscript;
@@ -49,32 +51,49 @@ export function extractJSON(raw) {
     return snippet;
 }
 /**
- * Deep Analysis Engine: Communicates with Cloudflare Workers AI.
+ * Deep Analysis Engine: Communicates with the AI provider.
  * Uses XML-structured prompts for better instruction following in smaller LLMs.
  */
-export async function analyzeDiff(diff) {
+export async function analyzeDiff(diff, fileName) {
     const config = getConfig();
     if (!config.ai.apiKey || !config.ai.accountId) {
-        throw new Error("Missing Cloudflare credentials in ~/.pika-review.yaml");
+        throw new Error("Missing AI provider credentials in ~/.pika-review.yaml");
     }
-    // Neuron Safety: Truncate input to protect the 10,000 daily free limit.
+    // Rate Limit Safety: Truncate input to protect the daily free limit.
     // 30,000 chars is roughly 7,500 tokens, leaving room for a detailed response.
     const MAX_CHARS = 30000;
     const safeDiff = diff.length > MAX_CHARS
-        ? diff.substring(0, MAX_CHARS) + "\n... [Content truncated for token safety]"
+        ? diff.substring(0, MAX_CHARS) +
+            "\n... [Content truncated for token safety]"
         : diff;
-    const baseURL = (config.ai.baseURL && config.ai.baseURL.trim())
+    const baseURL = config.ai.baseURL && config.ai.baseURL.trim()
         ? config.ai.baseURL
         : `https://api.cloudflare.com/client/v4/accounts/${config.ai.accountId}/ai/v1`;
     const openai = new OpenAI({
         apiKey: config.ai.apiKey,
         baseURL,
     });
+    // Load custom architecture rules if they exist
+    let complianceSection = "";
+    try {
+        const rulesPath = path.join(process.cwd(), ".pika-rules.md");
+        if (fs.existsSync(rulesPath)) {
+            complianceSection = `
+<compliance_standards>
+${fs.readFileSync(rulesPath, "utf-8")}
+</compliance_standards>`;
+        }
+    }
+    catch (e) { }
     const defaultPrompt = `
 <role>
   You are an Elite Senior Full-Stack Architect and Security Researcher.
   Your task is to perform a surgical review of the provided code.
-</role>
+</role>${complianceSection}
+
+<context>
+  Reviewing File: ${fileName}
+</context>
 
 <task>
   Identify high-impact issues related to:
@@ -112,7 +131,7 @@ export async function analyzeDiff(diff) {
 ${safeDiff}
 </code_to_analyze>
 `;
-    const finalPrompt = (config.ai.prompt && config.ai.prompt.trim())
+    const finalPrompt = config.ai.prompt && config.ai.prompt.trim()
         ? config.ai.prompt.replace("{{code}}", safeDiff)
         : defaultPrompt;
     try {

package/dist/core/reporter.js

@@ -1,12 +1,38 @@
 import fs from "fs";
 import path from "path";
 /**
- * Report Orchestrator: Handles persistence of AI findings.
+ * Helper to get a sanitized project name.
+ */
+function getProjectName() {
+    try {
+        const pkgPath = path.join(process.cwd(), "package.json");
+        if (fs.existsSync(pkgPath)) {
+            const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+            if (pkg.name)
+                return pkg.name.replace(/\//g, "-");
+        }
+    }
+    catch (e) { }
+    return path.basename(process.cwd());
+}
+/**
+ * Helper to generate a safe filename from a path.
+ */
+function getSafeFileName(fileName) {
+    return fileName.replace(/[^a-z0-9]/gi, "_").toLowerCase();
+}
+/**
+ * Report Orchestrator: Handles persistence of AI findings in a structured way.
+ * Stores reports in .pika-reports/<project-name>/<timestamp>/
  */
 export function setupReportDir() {
-    const reportDir = path.join(process.cwd(), ".pika-reports");
-    if (!fs.existsSync(reportDir))
-        fs.mkdirSync(reportDir);
+    const rootReportDir = path.join(process.cwd(), ".pika-reports");
+    const projectName = getProjectName();
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 16);
+    const sessionDir = path.join(rootReportDir, projectName, timestamp);
+    if (!fs.existsSync(sessionDir)) {
+        fs.mkdirSync(sessionDir, { recursive: true });
+    }
     const gitignorePath = path.join(process.cwd(), ".gitignore");
     if (fs.existsSync(gitignorePath)) {
         const gitignore = fs.readFileSync(gitignorePath, "utf-8");
@@ -14,13 +40,13 @@ export function setupReportDir() {
             fs.appendFileSync(gitignorePath, "\n.pika-reports/\n");
         }
     }
-    return reportDir;
+    return sessionDir;
 }
 /**
  * Generates a professional Markdown report.
  */
 export function writeMarkdownReport(fileName, reviews, reportDir) {
-    const safeName = fileName.replace(/[^a-z0-9]/gi, "_").toLowerCase();
+    const safeName = getSafeFileName(fileName);
     const reportPath = path.join(reportDir, `${safeName}_review.md`);
     const timestamp = new Date().toLocaleString();
     let mdContent = `# 🔍 Pika Review: \`${fileName}\`\n\n`;
@@ -46,3 +72,414 @@ export function writeMarkdownReport(fileName, reviews, reportDir) {
     fs.writeFileSync(reportPath, mdContent);
     return reportPath;
 }
+/**
+ * Generates a premium Interactive HTML report.
+ */
+export function writeHTMLReport(sessionDir, totalFiles, allFindings) {
+    const reportPath = path.join(sessionDir, `report.html`);
+    const projectName = getProjectName();
+    const timestamp = new Date().toLocaleString();
+    const data = JSON.stringify(allFindings);
+    const htmlContent = `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Pika Review | ${projectName}</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
+    <style>
+        :root {
+            --bg: #0b0f1a;
+            --sidebar-bg: #151b2d;
+            --card-bg: #1e253a;
+            --text: #f1f5f9;
+            --text-dim: #94a3b8;
+            --accent: #38bdf8;
+            --critical: #f43f5e;
+            --high: #fb923c;
+            --medium: #fbbf24;
+            --low: #4ade80;
+            --border: rgba(255,255,255,0.08);
+        }
+
+        * { margin: 0; padding: 0; box-sizing: border-box; }
+        body { 
+            font-family: 'Inter', sans-serif; 
+            background: var(--bg); 
+            color: var(--text);
+            display: flex;
+            height: 100vh;
+            overflow: hidden;
+        }
+
+        /* Sidebar */
+        aside {
+            width: 350px;
+            background: var(--sidebar-bg);
+            border-right: 1px solid var(--border);
+            display: flex;
+            flex-direction: column;
+            box-shadow: 10px 0 30px rgba(0,0,0,0.3);
+            z-index: 10;
+        }
+
+        .brand {
+            padding: 32px 24px;
+            border-bottom: 1px solid var(--border);
+            background: linear-gradient(135deg, rgba(56, 189, 248, 0.1), transparent);
+        }
+
+        .brand h1 { font-size: 1.5rem; font-weight: 800; letter-spacing: -0.02em; color: var(--accent); display: flex; align-items: center; gap: 10px; }
+        .brand p { font-size: 0.8rem; color: var(--text-dim); margin-top: 8px; font-weight: 500; }
+
+        .sidebar-stats {
+            padding: 20px 24px;
+            display: grid;
+            grid-template-columns: 1fr 1fr;
+            gap: 12px;
+            border-bottom: 1px solid var(--border);
+        }
+
+        .stat-box {
+            background: rgba(255,255,255,0.03);
+            padding: 12px;
+            border-radius: 10px;
+            text-align: center;
+            border: 1px solid var(--border);
+        }
+
+        .stat-val { display: block; font-size: 1.25rem; font-weight: 700; color: var(--accent); }
+        .stat-lab { display: block; font-size: 0.65rem; text-transform: uppercase; color: var(--text-dim); margin-top: 4px; letter-spacing: 0.05em; }
+
+        .file-list {
+            flex: 1;
+            overflow-y: auto;
+            padding: 16px;
+        }
+
+        .file-item {
+            padding: 14px 16px;
+            border-radius: 12px;
+            cursor: pointer;
+            margin-bottom: 8px;
+            transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+            display: flex;
+            flex-direction: column;
+            gap: 6px;
+            border: 1px solid transparent;
+        }
+
+        .file-item:hover { background: rgba(255,255,255,0.04); border-color: var(--border); }
+        .file-item.active { background: var(--accent); color: #000; box-shadow: 0 4px 15px rgba(56, 189, 248, 0.3); }
+        .file-item .name { font-size: 0.85rem; font-family: 'JetBrains Mono', monospace; font-weight: 500; word-break: break-all; }
+        
+        .severity-pills { display: flex; gap: 4px; }
+        .pill { font-size: 0.65rem; padding: 2px 6px; border-radius: 4px; background: rgba(0,0,0,0.2); font-weight: 700; }
+        .file-item.active .pill { background: rgba(0,0,0,0.1); color: #000; }
+
+        /* Main Content */
+        main {
+            flex: 1;
+            overflow-y: auto;
+            padding: 60px;
+            background: radial-gradient(circle at top right, rgba(56, 189, 248, 0.05), transparent 40%);
+        }
+
+        .content-container { max-width: 900px; margin: 0 auto; }
+
+        .page-header {
+            margin-bottom: 50px;
+            animation: fadeInDown 0.5s ease-out;
+        }
+
+        @keyframes fadeInDown {
+            from { opacity: 0; transform: translateY(-20px); }
+            to { opacity: 1; transform: translateY(0); }
+        }
+
+        .page-header h2 { font-size: 2rem; font-family: 'JetBrains Mono', monospace; margin-bottom: 12px; color: #fff; }
+        .page-header p { color: var(--text-dim); font-size: 1rem; }
+
+        .issue-card {
+            background: var(--card-bg);
+            border: 1px solid var(--border);
+            border-radius: 20px;
+            padding: 32px;
+            margin-bottom: 30px;
+            position: relative;
+            box-shadow: 0 10px 40px rgba(0,0,0,0.2);
+            transition: transform 0.3s;
+        }
+
+        .issue-card:hover { transform: translateY(-4px); }
+
+        .card-accent {
+            position: absolute;
+            left: 0; top: 32px; bottom: 32px;
+            width: 5px;
+            border-radius: 0 4px 4px 0;
+        }
+
+        .issue-card.Critical .card-accent { background: var(--critical); box-shadow: 0 0 15px var(--critical); }
+        .issue-card.High .card-accent { background: var(--high); box-shadow: 0 0 15px var(--high); }
+        .issue-card.Medium .card-accent { background: var(--medium); box-shadow: 0 0 15px var(--medium); }
+        .issue-card.Low .card-accent { background: var(--low); box-shadow: 0 0 15px var(--low); }
+
+        .issue-meta {
+            display: flex;
+            align-items: center;
+            justify-content: space-between;
+            margin-bottom: 24px;
+        }
+
+        .severity-tag {
+            font-size: 0.75rem;
+            text-transform: uppercase;
+            font-weight: 800;
+            padding: 6px 14px;
+            border-radius: 8px;
+            letter-spacing: 0.05em;
+        }
+
+        .severity-tag.Critical { background: rgba(244, 63, 94, 0.15); color: var(--critical); border: 1px solid var(--critical); }
+        .severity-tag.High { background: rgba(251, 146, 60, 0.15); color: var(--high); border: 1px solid var(--high); }
+        .severity-tag.Medium { background: rgba(251, 191, 36, 0.15); color: var(--medium); border: 1px solid var(--medium); }
+        .severity-tag.Low { background: rgba(74, 222, 128, 0.15); color: var(--low); border: 1px solid var(--low); }
+
+        .line-info { font-family: 'JetBrains Mono', monospace; color: var(--text-dim); font-size: 0.9rem; }
+
+        .field-group { margin-bottom: 24px; }
+        .field-label {
+            font-size: 0.7rem;
+            font-weight: 800;
+            color: var(--text-dim);
+            text-transform: uppercase;
+            letter-spacing: 0.1em;
+            margin-bottom: 10px;
+            display: flex;
+            align-items: center;
+            gap: 8px;
+        }
+
+        .field-content { line-height: 1.7; color: #cbd5e1; font-size: 1.05rem; }
+
+        pre {
+            background: #000;
+            padding: 24px;
+            border-radius: 12px;
+            font-family: 'JetBrains Mono', monospace;
+            font-size: 0.9rem;
+            margin-top: 15px;
+            overflow-x: auto;
+            border: 1px solid rgba(255,255,255,0.05);
+            color: #e2e8f0;
+        }
+
+        .empty-state {
+            display: flex;
+            flex-direction: column;
+            align-items: center;
+            justify-content: center;
+            height: 60vh;
+            text-align: center;
+            opacity: 0.6;
+        }
+
+        .empty-state svg { width: 80px; height: 80px; margin-bottom: 24px; stroke: var(--text-dim); }
+
+        /* Scrollbar */
+        ::-webkit-scrollbar { width: 6px; }
+        ::-webkit-scrollbar-track { background: transparent; }
+        ::-webkit-scrollbar-thumb { background: rgba(255,255,255,0.1); border-radius: 10px; }
+        ::-webkit-scrollbar-thumb:hover { background: var(--accent); }
+    </style>
+</head>
+<body>
+    <aside>
+        <div class="brand">
+            <h1>🦊 PIKA REVIEW</h1>
+            <p>${projectName} • ${timestamp}</p>
+        </div>
+        <div class="sidebar-stats">
+            <div class="stat-box">
+                <span class="stat-val" id="totalFiles">0</span>
+                <span class="stat-lab">Files</span>
+            </div>
+            <div class="stat-box">
+                <span class="stat-val" id="totalIssues">0</span>
+                <span class="stat-lab">Issues</span>
+            </div>
+        </div>
+        <div class="file-list" id="fileList"></div>
+    </aside>
+
+    <main>
+        <div class="content-container" id="mainContent">
+            <div class="empty-state">
+                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round"><circle cx="11" cy="11" r="8"></circle><line x1="21" y1="21" x2="16.65" y2="16.65"></line></svg>
+                <h3>Select a file to inspect</h3>
+                <p>Architectural findings and security insights will appear here.</p>
+            </div>
+        </div>
+    </main>
+
+    <script id="pika-data" type="application/json">${data}</script>
+    <script>
+        (function() {
+            const findings = JSON.parse(document.getElementById('pika-data').textContent);
+            const fileList = document.getElementById('fileList');
+            const mainContent = document.getElementById('mainContent');
+            const totalFilesEl = document.getElementById('totalFiles');
+            const totalIssuesEl = document.getElementById('totalIssues');
+
+            function escape(str) {
+                if (!str) return '';
+                const div = document.createElement('div');
+                div.textContent = str;
+                return div.innerHTML;
+            }
+
+            function init() {
+                totalFilesEl.textContent = findings.length;
+                let issuesCount = 0;
+                
+                findings.forEach((f, index) => {
+                    issuesCount += f.reviews.length;
+                    const item = document.createElement('div');
+                    item.className = 'file-item';
+                    
+                    const name = document.createElement('span');
+                    name.className = 'name';
+                    name.textContent = f.fileName;
+                    item.appendChild(name);
+
+                    if (f.reviews.length > 0) {
+                        const pills = document.createElement('div');
+                        pills.className = 'severity-pills';
+                        
+                        const counts = f.reviews.reduce((acc, r) => {
+                            acc[r.severity] = (acc[r.severity] || 0) + 1;
+                            return acc;
+                        }, {});
+
+                        Object.entries(counts).forEach(([sev, count]) => {
+                            const pill = document.createElement('span');
+                            pill.className = 'pill';
+                            pill.style.color = 'var(--' + sev.toLowerCase() + ')';
+                            pill.textContent = count;
+                            pills.appendChild(pill);
+                        });
+                        item.appendChild(pills);
+                    } else {
+                        const clean = document.createElement('span');
+                        clean.className = 'pill';
+                        clean.style.color = 'var(--low)';
+                        clean.textContent = 'CLEAN';
+                        item.appendChild(clean);
+                    }
+
+                    item.onclick = () => selectFile(index, item);
+                    fileList.appendChild(item);
+                });
+
+                totalIssuesEl.textContent = issuesCount;
+            }
+
+            function selectFile(index, element) {
+                document.querySelectorAll('.file-item').forEach(i => i.classList.remove('active'));
+                element.classList.add('active');
+
+                const f = findings[index];
+                mainContent.innerHTML = '';
+
+                const header = document.createElement('div');
+                header.className = 'page-header';
+                
+                const title = document.createElement('h2');
+                title.textContent = f.fileName;
+                header.appendChild(title);
+
+                const subtitle = document.createElement('p');
+                subtitle.textContent = f.reviews.length + ' findings identified in this analysis.';
+                header.appendChild(subtitle);
+                
+                mainContent.appendChild(header);
+
+                if (f.reviews.length === 0) {
+                    const empty = document.createElement('div');
+                    empty.className = 'empty-state';
+                    empty.innerHTML = '<h3>✨ Code is pristine</h3><p>No architectural anomalies or security risks found in this file.</p>';
+                    mainContent.appendChild(empty);
+                    return;
+                }
+
+                f.reviews.forEach(r => {
+                    const card = document.createElement('div');
+                    card.className = 'issue-card ' + r.severity;
+                    
+                    card.innerHTML = [
+                        '<div class="card-accent"></div>',
+                        '<div class="issue-meta">',
+                            '<span class="severity-tag ' + r.severity + '">' + r.severity + '</span>',
+                            '<span class="line-info">Line ' + (r.line || 'N/A') + '</span>',
+                        '</div>',
+                        '<div class="field-group">',
+                            '<div class="field-label">💡 Finding</div>',
+                            '<div class="field-content">' + escape(r.finding) + '</div>',
+                        '</div>',
+                        '<div class="field-group">',
+                            '<div class="field-label">💥 Impact</div>',
+                            '<div class="field-content">' + escape(r.impact) + '</div>',
+                        '</div>',
+                        '<div class="field-group">',
+                            '<div class="field-label">🛠️ Recommendation</div>',
+                            '<pre><code>' + escape(r.recommendation) + '</code></pre>',
+                        '</div>'
+                    ].join('');
+
+                    mainContent.appendChild(card);
+                });
+
+                mainContent.scrollTop = 0;
+            }
+
+            init();
+        })();
+    </script>
+</body>
+</html>
+`;
+    fs.writeFileSync(reportPath, htmlContent);
+    // Point 2: Update history.json for stats tracking
+    try {
+        const historyPath = path.join(process.cwd(), ".pika-reports", "history.json");
+        let history = [];
+        if (fs.existsSync(historyPath)) {
+            history = JSON.parse(fs.readFileSync(historyPath, "utf-8"));
+        }
+        const totalIssues = allFindings.reduce((sum, f) => sum + f.reviews.length, 0);
+        const severityCounts = allFindings.reduce((acc, f) => {
+            f.reviews.forEach(r => {
+                acc[r.severity] = (acc[r.severity] || 0) + 1;
+            });
+            return acc;
+        }, { Critical: 0, High: 0, Medium: 0, Low: 0 });
+        history.push({
+            timestamp: new Date().toISOString(),
+            projectName,
+            totalFiles,
+            totalIssues,
+            severityCounts,
+            reportPath: path.relative(path.join(process.cwd(), ".pika-reports"), reportPath)
+        });
+        // Keep only last 50 runs to prevent file bloat
+        if (history.length > 50)
+            history.shift();
+        fs.writeFileSync(historyPath, JSON.stringify(history, null, 2));
+    }
+    catch (e) { }
+    return reportPath;
+}

package/dist/core/scanner.js

@@ -3,7 +3,7 @@ import fs from "fs";
 import cliProgress from "cli-progress";
 import pLimit from "p-limit";
 import { analyzeDiff } from "./ai.js";
-import { setupReportDir, writeMarkdownReport } from "./reporter.js";
+import { setupReportDir, writeMarkdownReport, writeHTMLReport } from "./reporter.js";
 import { getIgnoredFiles } from "../utils/config.js";
 import { logger } from "../utils/logger.js";
 import path from "path";
@@ -65,7 +65,7 @@ export function getDiffFiles(type) {
 }
 /**
  * Scan Orchestrator: Manages the review lifecycle.
- * Concurrency is limited to 3 to stay within the Cloudflare Workers AI free tier constraints.
+ * Concurrency is limited to 3 to stay within default provider free tier constraints.
  */
 export async function runScan(target, isCI, specificFiles) {
     let files = [];
@@ -98,6 +98,7 @@ export async function runScan(target, isCI, specificFiles) {
     if (bar)
         bar.start(files.length, 0, { file: "Starting..." });
     const generatedReports = [];
+    const allFindings = [];
     let criticalIssuesFound = false;
     const limit = pLimit(3);
     let completed = 0;
@@ -115,7 +116,7 @@ export async function runScan(target, isCI, specificFiles) {
             }
             else {
                 try {
-                    contentToScan = execFileSync("git", ["diff", target === "staged" ? "--cached" : "", "--", file], {
+                    contentToScan = execFileSync("git", ["diff", "-U10", target === "staged" ? "--cached" : "", "--", file], {
                         encoding: "utf-8",
                         stdio: ["ignore", "pipe", "ignore"] // Suppress stderr
                     });
@@ -134,20 +135,42 @@ export async function runScan(target, isCI, specificFiles) {
             }
             // Token Estimator Check
             validateTokenLimit(contentToScan);
-            const result = await analyzeDiff(contentToScan);
+            const result = await analyzeDiff(contentToScan, file);
             if (result.reviews.length > 0) {
-                const hasCritical = result.reviews.some(r => r.severity === "Critical" || r.severity === "High");
-                if (hasCritical)
-                    criticalIssuesFound = true;
-                const reportPath = writeMarkdownReport(file, result.reviews, reportDir);
-                generatedReports.push(reportPath);
+                // Point 5: "Ignore" Comments Logic
+                const filteredReviews = result.reviews.filter(r => {
+                    if (!r.line)
+                        return true;
+                    try {
+                        const fileLines = fs.readFileSync(file, "utf-8").split("\n");
+                        const targetLineContent = fileLines[r.line - 1] || "";
+                        if (targetLineContent.includes("pika-ignore"))
+                            return false;
+                    }
+                    catch (e) { }
+                    return true;
+                });
+                if (filteredReviews.length > 0) {
+                    const hasCritical = filteredReviews.some(r => r.severity === "Critical" || r.severity === "High");
+                    if (hasCritical)
+                        criticalIssuesFound = true;
+                    const reportPath = writeMarkdownReport(file, filteredReviews, reportDir);
+                    generatedReports.push(reportPath);
+                    allFindings.push({ fileName: file, reviews: filteredReviews });
+                }
+                else {
+                    allFindings.push({ fileName: file, reviews: [] });
+                }
+            }
+            else {
+                allFindings.push({ fileName: file, reviews: [] });
             }
         }
         catch (e) {
             if (e.message === "RATE_LIMIT") {
                 if (bar)
                     bar.stop();
-                logger.critical("DAILY NEURON LIMIT REACHED (10,000). Scanning aborted.");
+                logger.critical("DAILY RATE LIMIT REACHED. Scanning aborted.");
                 process.exit(1);
             }
             logger.error(`Error scanning ${file}: ${e.message}`);
@@ -165,5 +188,10 @@ export async function runScan(target, isCI, specificFiles) {
         logger.critical("CI Pipeline Failed: Critical issues detected.");
         process.exit(1);
     }
+    const htmlPath = writeHTMLReport(reportDir, files.length, allFindings);
+    if (!isCI) {
+        logger.success("\nScan complete!");
+        logger.info(`Interactive Report: ${htmlPath}`);
+    }
     return generatedReports;
 }

package/dist/index.js

@@ -3,6 +3,8 @@ import { Command } from "commander";
 import chalk from "chalk";
 import { initAction } from "./cmd/init.js";
 import { scanAction } from "./cmd/scan.js";
+import { viewAction } from "./cmd/view.js";
+import { statsAction } from "./cmd/stats.js";
 /**
  * Pika Review: The Enterprise-Grade AI Code Reviewer.
  * Modular entry point for CLI operations.
@@ -10,19 +12,22 @@ import { scanAction } from "./cmd/scan.js";
 const program = new Command();
 // Branding Header
 const BRAND = `
-  ${chalk.bgCyan.black.bold(" PIKA REVIEW ")} ${chalk.dim("v2.0.0")}
-  ${chalk.italic.gray("Enterprise-grade AI Architectural Sentinel")}
+  ${chalk.bgCyan.black.bold(" PIKA REVIEW ")} ${chalk.dim("v2.0.0 Enterprise")}
+  ${chalk.italic.gray("AI Architectural Sentinel & Compliance Engine")}
 `;
 const HELPER_TEXT = `
 ${chalk.bold.cyan("🚀 Quick Start:")}
   $ pika-review scan           ${chalk.dim("# Scan staged git changes (default)")}
-  $ pika-review scan -u        ${chalk.dim("# Scan unstaged git changes")}
+  $ pika-review scan -i        ${chalk.dim("# Interactive file selection mode")}
+  $ pika-review view           ${chalk.dim("# Open the latest interactive report")}
+  $ pika-review stats          ${chalk.dim("# View architectural health trends")}
   $ pika-review scan file.ts   ${chalk.dim("# Scan a specific file")}
   $ pika-review scan f1 f2     ${chalk.dim("# Scan multiple specific files")}
 
 ${chalk.bold.cyan("⌨️  Shortcuts & Tips:")}
   - Use ${chalk.yellow("--ci")} in GitHub Actions to fail on Critical/High issues.
-  - Create a ${chalk.yellow(".pikaignore")} file to skip specific directories.
+  - Create ${chalk.yellow(".pika-rules.md")} to enforce project-specific architecture.
+  - Use ${chalk.yellow("pika-ignore")} in code comments to skip specific lines.
   - Review artifacts are stored in ${chalk.yellow(".pika-reports/")} automatically.
 
 ${chalk.bold.cyan("📊 Progress & Concurrency:")}
@@ -31,7 +36,7 @@ ${chalk.bold.cyan("📊 Progress & Concurrency:")}
 `;
 program
     .name("pika-review")
-    .description("Enterprise-grade AI Code Reviewer for Cloudflare Workers AI")
+    .description("Enterprise-grade AI Architectural Code Reviewer")
     .version("2.0.0")
     .addHelpText("before", BRAND)
     .addHelpText("after", HELPER_TEXT);
@@ -42,10 +47,25 @@ program
     console.log(BRAND);
     await initAction();
 });
+program
+    .command("view")
+    .description("Open the latest interactive HTML report in your browser")
+    .action(async () => {
+    console.log(BRAND);
+    await viewAction();
+});
+program
+    .command("stats")
+    .description("View architectural health trends and scan history")
+    .action(async () => {
+    console.log(BRAND);
+    await statsAction();
+});
 program
     .command("scan [files...]", { isDefault: true }) // Set scan as the default command
     .description("Scan git changes or specific files for architectural anomalies")
     .option("-u, --unstaged", "Analyze unstaged changes instead of staged")
+    .option("-i, --interactive", "Interactively select files to scan")
     .option("--ci", "Headless CI/CD mode (fails on Critical/High issues, strips visuals)")
     .action(async (files, options) => {
     // Only show branding if not in CI mode and if files were explicitly passed or if it's the default

package/dist/utils/config.js

@@ -6,11 +6,11 @@ import { logger } from "./logger.js";
 const CONFIG_PATH = path.join(os.homedir(), ".pika-review.yaml");
 const DEFAULT_CONFIG = {
     ai: {
-        accountId: "", // Required for Cloudflare default
+        accountId: "", // Account ID if required by provider
         apiKey: "",
         model: "@cf/meta/llama-3-8b-instruct",
         prompt: "",
-        baseURL: "", // Leave empty for Cloudflare, or set for OpenAI/Grok/Local
+        baseURL: "", // Leave empty for default provider, or set for custom API
     },
 };
 /**
@@ -23,7 +23,7 @@ export function initConfig() {
             mode: 0o600,
         });
         logger.success(`Configuration initialized at ${CONFIG_PATH}`);
-        logger.info("Please edit this file and add your Cloudflare Account ID and API Token.");
+        logger.info("Please edit this file and add your AI provider credentials.");
     }
     else {
         logger.warn(`Configuration already exists at ${CONFIG_PATH}`);
@@ -46,13 +46,44 @@ export function getIgnoredFiles() {
     const ignorePath = path.join(process.cwd(), ".pikaignore");
     if (!fs.existsSync(ignorePath)) {
         return [
-            ".svg", ".lock", "package-lock.json", ".png", ".jpg", ".jpeg", ".ico",
-            "node_modules", ".git", "dist", "build", "out", ".next", "public",
-            ".pika-reports", ".env", ".DS_Store", "bun.lockb", "pnpm-lock.yaml",
-            "venv", ".venv", "__pycache__", ".pytest_cache",
-            "target", ".gradle", ".idea", ".vscode", "vendor",
-            "coverage", ".turbo", "tests", "__tests__", "spec", "specs",
-            "cypress", "playwright-report", "test-results", ".nyc_output"
+            ".svg",
+            ".lock",
+            "package-lock.json",
+            ".png",
+            ".jpg",
+            ".jpeg",
+            ".ico",
+            "node_modules",
+            ".git",
+            "dist",
+            "build",
+            "out",
+            ".next",
+            "public",
+            ".pika-reports",
+            ".env",
+            ".DS_Store",
+            "bun.lockb",
+            "pnpm-lock.yaml",
+            "venv",
+            ".venv",
+            "__pycache__",
+            ".pytest_cache",
+            "target",
+            ".gradle",
+            ".idea",
+            ".vscode",
+            "vendor",
+            "coverage",
+            ".turbo",
+            "tests",
+            "__tests__",
+            "spec",
+            "specs",
+            "cypress",
+            "playwright-report",
+            "test-results",
+            ".nyc_output",
         ];
     }
     const content = fs.readFileSync(ignorePath, "utf-8");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pika-review",
-  "version": "2.0.1",
-  "description": "Enterprise-grade AI Architectural Code Reviewer powered by Cloudflare Workers AI.",
+  "version": "2.1.0",
+  "description": "Enterprise-grade AI Architectural Code Reviewer.",
   "main": "./dist/index.js",
   "type": "module",
   "repository": {
@@ -29,8 +29,6 @@
   "keywords": [
     "ai",
     "code-review",
-    "cloudflare",
-    "workers-ai",
     "architectural-analysis",
     "cli"
   ],