pika-review 2.1.0 → 2.2.0

package/README.md

@@ -11,12 +11,15 @@ Pika Review is a high-performance CLI tool designed to perform surgical code rev
 ## 🚀 Key Features
 
 - **🧠 Architecture Rules Engine**: Enforce project-specific standards via `.pika-rules.md`.
+- **🦙 Native Local Ollama Support**: Run 100% private, free, offline scans using local LLMs (e.g. Qwen, Llama).
+- **🎛️ Local Model Selector**: Interactively choose and configure local models from the command line.
+- **🛡️ Git Commit Safeguard Hook**: Prevent pushing high-severity compliance debt and vulnerabilities automatically.
 - **📊 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.
+- **🌍 Provider Agnostic**: Works with OpenAI, Claude, Grok, local Ollama, or any OpenAI-compatible endpoint.
 
 ---
 
@@ -80,13 +83,57 @@ 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 |
+| 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 trends and scan dashboard          |
+| `pika-review models`    | Interactively select and configure local Ollama models       |
+| `pika-review hook <act>`| Install (`install`) or uninstall (`uninstall`) Git safeguards |
+| `pika-review rules -g`  | Auto-generate architectural `.pika-rules.md` guidelines       |
+| `pika-review scan --ci` | Fail pipeline on Critical/High issues                        |
+
+---
+
+## 🦙 Local Ollama & Offline Setup
+
+Pika Review fully supports local, 100% private, offline code reviews via [Ollama](https://ollama.com).
+
+### 1. Configure Ollama Provider
+Initialize your configuration:
+```bash
+pika-review init
+```
+Open `~/.pika-review.yaml` and configure the Ollama provider:
+```yaml
+ai:
+  provider: "ollama"
+  model: "qwen2.5-coder:7b" # Or your pulled model
+  baseURL: "http://localhost:11434/v1"
+```
+
+### 2. Interactive Local Setup
+To avoid editing files manually, you can manage everything directly from the command line:
+
+```bash
+# Discover local pulled models and switch active model instantly
+pika-review models
+
+# Automatically bootstrap customized architectural rules for your tech stack
+pika-review rules --generate
+
+# Register git safeguard hooks to run scans automatically before commits
+pika-review hook install
+```
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions from the community to help make Pika Review the ultimate architectural code reviewer! 
+
+Please read our **[Contributing Guide](CONTRIBUTING.md)** for details on how to set up local development, run compiler checks, write custom CLI commands, and submit high-quality Pull Requests.
 
 ---
 

package/dist/cmd/hook.js

@@ -0,0 +1,85 @@
+import fs from "fs";
+import path from "path";
+import chalk from "chalk";
+import { logger } from "../utils/logger.js";
+/**
+ * CLI Command Action: hook [action]
+ * Manages the Git pre-commit hook installation/removal.
+ */
+export async function hookAction(action) {
+    const gitPath = path.join(process.cwd(), ".git");
+    if (!fs.existsSync(gitPath)) {
+        logger.error("Not a Git repository.");
+        logger.dim("Pika Review Git hooks can only be installed in the root of a Git repository.");
+        return;
+    }
+    const hooksPath = path.join(gitPath, "hooks");
+    const hookFile = path.join(hooksPath, "pre-commit");
+    // Ensure hooks directory exists
+    if (!fs.existsSync(hooksPath)) {
+        fs.mkdirSync(hooksPath, { recursive: true });
+    }
+    const HOOK_SCRIPT = `#!/bin/sh
+# Pika Review - Architectural Sentinel Git Safeguard Hook
+echo "🦊 Running local architectural compliance checks..."
+pika-review scan --ci
+
+EXIT_CODE=$?
+if [ $EXIT_CODE -ne 0 ]; then
+  echo "❌ [Pika Review] Commit rejected due to high-severity compliance anomalies."
+  exit $EXIT_CODE
+fi
+
+exit 0
+`;
+    if (action === "install") {
+        let backupCreated = false;
+        if (fs.existsSync(hookFile)) {
+            const content = fs.readFileSync(hookFile, "utf-8");
+            if (content.includes("Pika Review")) {
+                logger.info("Pika Review hook is already installed!");
+                return;
+            }
+            // Create backup of existing hook
+            const backupPath = `${hookFile}.bak`;
+            fs.writeFileSync(backupPath, content);
+            backupCreated = true;
+            logger.info(`Existing hook backed up to ${chalk.cyan("pre-commit.bak")}`);
+        }
+        try {
+            fs.writeFileSync(hookFile, HOOK_SCRIPT, { mode: 0o755 });
+            logger.success("Git pre-commit hook installed successfully!");
+            logger.info(`Path: ${chalk.dim(hookFile)}`);
+            logger.dim("Pika Review will now scan your staged files automatically before every commit.");
+        }
+        catch (e) {
+            logger.error(`Failed to install Git hook: ${e.message}`);
+        }
+    }
+    else if (action === "uninstall") {
+        if (!fs.existsSync(hookFile)) {
+            logger.warn("No pre-commit hook found to uninstall.");
+            return;
+        }
+        const content = fs.readFileSync(hookFile, "utf-8");
+        if (!content.includes("Pika Review")) {
+            logger.warn("The existing pre-commit hook was not installed by Pika Review. Leaving it untouched.");
+            return;
+        }
+        try {
+            fs.unlinkSync(hookFile);
+            logger.success("Pika Review Git pre-commit hook uninstalled successfully.");
+            // Restore backup if it exists
+            const backupPath = `${hookFile}.bak`;
+            if (fs.existsSync(backupPath)) {
+                fs.renameSync(backupPath, hookFile);
+                // Make sure it remains executable
+                fs.chmodSync(hookFile, 0o755);
+                logger.success("Restored previous pre-commit hook from backup!");
+            }
+        }
+        catch (e) {
+            logger.error(`Failed to uninstall Git hook: ${e.message}`);
+        }
+    }
+}

package/dist/cmd/models.js

@@ -0,0 +1,68 @@
+import prompts from "prompts";
+import chalk from "chalk";
+import { getConfig, saveConfig } from "../utils/config.js";
+import { logger } from "../utils/logger.js";
+/**
+ * CLI Command Action: models
+ * Queries local Ollama daemon for available models and updates active configuration.
+ */
+export async function modelsAction() {
+    const config = getConfig();
+    // Extract base host from configuration baseURL or fallback to localhost
+    let host = "http://localhost:11434";
+    if (config.ai.baseURL) {
+        try {
+            const url = new URL(config.ai.baseURL);
+            host = `${url.protocol}//${url.host}`;
+        }
+        catch (e) { }
+    }
+    logger.info(`Connecting to Ollama daemon at ${chalk.cyan(host)}...`);
+    try {
+        const res = await fetch(`${host}/api/tags`);
+        if (!res.ok) {
+            throw new Error(`Server returned HTTP ${res.status}`);
+        }
+        const data = (await res.json());
+        if (!data.models || data.models.length === 0) {
+            logger.warn(`No models found inside your local Ollama instance.`);
+            logger.info(`Try pulling a model first using: ${chalk.yellow("ollama pull llama3")}`);
+            return;
+        }
+        const choices = data.models.map((m) => {
+            const sizeGB = m.size ? `${(m.size / (1024 * 1024 * 1024)).toFixed(2)} GB` : "Unknown size";
+            const paramSize = m.details?.parameter_size ? ` [${m.details.parameter_size}]` : "";
+            return {
+                title: `${chalk.bold(m.name)} ${chalk.dim(`(${sizeGB}${paramSize})`)}`,
+                value: m.name,
+            };
+        });
+        const response = await prompts({
+            type: "select",
+            name: "model",
+            message: "Select your active local Ollama model:",
+            choices,
+            initial: 0,
+        });
+        if (response.model) {
+            config.ai.provider = "ollama";
+            config.ai.model = response.model;
+            // Auto-set standard baseURL if empty or not set to localhost
+            if (!config.ai.baseURL || config.ai.baseURL.includes("cloudflare")) {
+                config.ai.baseURL = "http://localhost:11434/v1";
+            }
+            saveConfig(config);
+            logger.success(`Configuration updated successfully!`);
+            logger.info(`Active Model:   ${chalk.green(response.model)}`);
+            logger.info(`AI Provider:    ${chalk.cyan("ollama")}`);
+            logger.info(`API Base URL:   ${chalk.cyan(config.ai.baseURL)}`);
+        }
+    }
+    catch (error) {
+        logger.error(`Could not connect to Ollama daemon.`);
+        console.log(chalk.dim(`\n💡 To solve this, make sure:`));
+        console.log(` 1. Ollama is installed on your machine (https://ollama.com).`);
+        console.log(` 2. The daemon is running (${chalk.yellow("ollama serve")} or desktop application).`);
+        console.log(` 3. Your config baseURL is pointing to your active daemon (current: ${chalk.red(host)}).\n`);
+    }
+}

package/dist/cmd/rules.js

@@ -0,0 +1,114 @@
+import fs from "fs";
+import path from "path";
+import prompts from "prompts";
+import chalk from "chalk";
+import OpenAI from "openai";
+import { getConfig } from "../utils/config.js";
+import { listProjectFiles } from "../core/scanner.js";
+import { logger } from "../utils/logger.js";
+/**
+ * CLI Command Action: rules generate
+ * Uses the configured AI provider to bootstrap architectural rules tailored to the current codebase.
+ */
+export async function rulesAction() {
+    const config = getConfig();
+    const isOllama = config.ai.provider === "ollama";
+    if (!isOllama && (!config.ai.apiKey || !config.ai.accountId)) {
+        logger.error("Missing AI credentials in ~/.pika-review.yaml.");
+        logger.info("Run 'pika-review init' to initialize config or set provider to 'ollama' for offline mode.");
+        return;
+    }
+    const rulesPath = path.join(process.cwd(), ".pika-rules.md");
+    if (fs.existsSync(rulesPath)) {
+        const overwrite = await prompts({
+            type: "confirm",
+            name: "confirm",
+            message: "An existing .pika-rules.md already exists. Do you want to overwrite it?",
+            initial: false,
+        });
+        if (!overwrite.confirm) {
+            logger.info("Operation cancelled.");
+            return;
+        }
+    }
+    else {
+        const confirm = await prompts({
+            type: "confirm",
+            name: "confirm",
+            message: "Generate a custom, AI-crafted .pika-rules.md architectural guidelines guide for this codebase?",
+            initial: true,
+        });
+        if (!confirm.confirm) {
+            logger.info("Operation cancelled.");
+            return;
+        }
+    }
+    logger.info("Analyzing codebase structure and dependencies...");
+    // 1. Gather package.json context
+    let projectTechStack = "";
+    try {
+        const packageJsonPath = path.join(process.cwd(), "package.json");
+        if (fs.existsSync(packageJsonPath)) {
+            const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+            const deps = Object.keys(packageJson.dependencies || {}).join(", ");
+            const devDeps = Object.keys(packageJson.devDependencies || {}).join(", ");
+            projectTechStack += `Package Name: ${packageJson.name || "unknown"}\nDependencies: ${deps || "none"}\nDevDependencies: ${devDeps || "none"}\n`;
+        }
+    }
+    catch (e) { }
+    // 2. Gather file layout context
+    const files = listProjectFiles();
+    const fileSummary = files.slice(0, 30).map(f => ` - ${f}`).join("\n");
+    const projectStructure = `Detected files (subset):\n${fileSummary}\nTotal files discovered: ${files.length}\n`;
+    logger.info(`Synthesizing tailored rules using AI model (${chalk.green(config.ai.model)})...`);
+    const prompt = `You are an Elite Senior Software Architect and Compliance Officer.
+Your task is to write a highly detailed, professional, and practical architectural rules file called ".pika-rules.md" for a project with the following tech stack and structure:
+
+<project_tech_stack>
+${projectTechStack || "Generic web/software codebase"}
+</project_tech_stack>
+
+<project_structure>
+${projectStructure}
+</project_structure>
+
+Instructions:
+- Write the output in clean, professional Markdown format.
+- Establish 5 to 8 strict, concrete, actionable architectural rules tailored to the libraries, patterns, and folder layout of this specific project (e.g. naming conventions, folder segregation, API patterns, state management, security).
+- Provide a brief justification for each rule.
+- Do NOT output any preamble, greeting, markdown backticks wrapper, or postscript.
+- Start directly with "# Pika Architectural Rules" and start rules lists immediately.`;
+    const baseURL = config.ai.baseURL && config.ai.baseURL.trim()
+        ? config.ai.baseURL
+        : (isOllama
+            ? "http://localhost:11434/v1"
+            : `https://api.cloudflare.com/client/v4/accounts/${config.ai.accountId}/ai/v1`);
+    const openai = new OpenAI({
+        apiKey: config.ai.apiKey || "ollama",
+        baseURL,
+    });
+    try {
+        const response = await openai.chat.completions.create({
+            model: config.ai.model,
+            messages: [{ role: "user", content: prompt }],
+            temperature: 0.3,
+            max_tokens: 1500,
+        });
+        let rawMarkdown = response.choices[0]?.message?.content || "";
+        // Clean code block ticks if LLM ignored instructions
+        rawMarkdown = rawMarkdown
+            .replace(/```markdown/g, "")
+            .replace(/```/g, "")
+            .trim();
+        if (!rawMarkdown.startsWith("#")) {
+            rawMarkdown = `# Pika Architectural Rules\n\n${rawMarkdown}`;
+        }
+        fs.writeFileSync(rulesPath, rawMarkdown, "utf-8");
+        logger.success(".pika-rules.md generated successfully!");
+        logger.info(`Location: ${chalk.dim(rulesPath)}`);
+        logger.dim("The local Pika Review engine will now enforce these rules during future scans!");
+    }
+    catch (error) {
+        logger.error(`Failed to generate rules: ${error.message}`);
+    }
+}

package/dist/cmd/scan.js

@@ -1,5 +1,6 @@
 import prompts from "prompts";
 import chalk from "chalk";
+import { execSync } from "child_process";
 import { runScan, getDiffFiles, listProjectFiles } from "../core/scanner.js";
 import { logger } from "../utils/logger.js";
 /**
@@ -32,35 +33,80 @@ export async function scanAction(files, options) {
             }
         }
     }
-    let reports = await runScan(target, isCI, targets);
-    if (!reports || reports.length === 0) {
+    const { markdownReports, htmlReport, findings } = await runScan(target, isCI, targets);
+    if (!markdownReports || markdownReports.length === 0) {
         if (!isCI) {
-            logger.success("Scan complete. No critical architectural anomalies detected.");
-            logger.dim("Try scanning with '--unstaged' if you have uncommitted changes.");
+            console.log(`\n  ${chalk.green("✓")}  ${chalk.bold("Scan complete. No architectural anomalies or security risks detected.")}`);
+            console.log(`     ${chalk.dim("Try scanning with '--unstaged' if you have unstaged changes.")}\n`);
         }
         return;
     }
     if (!isCI) {
-        console.log(chalk.bold(`\n${"=".repeat(50)}`));
-        logger.warn(`ANALYTICAL REPORT READY`);
-        logger.dim(`${reports.length} file(s) require your immediate attention.\n`);
+        // Count findings by severity
+        let criticalCount = 0;
+        let highCount = 0;
+        let mediumCount = 0;
+        let lowCount = 0;
+        let totalIssues = 0;
+        findings.forEach((f) => {
+            totalIssues += f.reviews.length;
+            f.reviews.forEach((r) => {
+                if (r.severity === "Critical")
+                    criticalCount++;
+                else if (r.severity === "High")
+                    highCount++;
+                else if (r.severity === "Medium")
+                    mediumCount++;
+                else if (r.severity === "Low")
+                    lowCount++;
+            });
+        });
+        // Sleek summary box
+        console.log(`\n  ${chalk.cyan.bold("◆  Scan Completed Successfully")}`);
+        console.log(`     ${chalk.dim("─".repeat(34))}`);
+        console.log(`     ${chalk.bold("Files Audited:")}   ${findings.length}`);
+        console.log(`     ${chalk.bold("Total Findings:")}  ${totalIssues}`);
+        if (totalIssues > 0) {
+            console.log(`\n     ${chalk.bold("Severity Breakdown:")}`);
+            if (criticalCount > 0)
+                console.log(`       🚨 ${chalk.red.bold(criticalCount)} Critical`);
+            if (highCount > 0)
+                console.log(`       🔥 ${chalk.yellow.bold(highCount)} High`);
+            if (mediumCount > 0)
+                console.log(`       ⚠️ ${chalk.blue.bold(mediumCount)} Medium`);
+            if (lowCount > 0)
+                console.log(`       📝 ${chalk.gray.bold(lowCount)} Low`);
+        }
+        console.log(`\n     ${chalk.bold("Obsidian Report:")}  ${chalk.cyan.underline(`file://${htmlReport}`)}\n`);
         const response = await prompts({
             type: "select",
             name: "action",
-            message: "What is your next step?",
+            message: "Choose post-scan action:",
             choices: [
-                { title: "📂 Open generated Markdown reports", value: "view" },
+                { title: "✨ Open Interactive HTML Dashboard (Recommended)", value: "html" },
+                { title: "📂 List generated Markdown file paths", value: "markdown" },
                 { title: "🛑 Exit and start refactoring", value: "exit" },
             ],
             initial: 0,
         });
-        if (response.action === "view") {
-            logger.info("\nGenerated Artifacts:");
-            reports.forEach((r) => {
+        if (response.action === "html") {
+            console.log(`\n  ${chalk.cyan("→")} Opening interactive report in browser...`);
+            try {
+                const command = process.platform === "win32" ? "start" : process.platform === "darwin" ? "open" : "xdg-open";
+                execSync(`${command} "${htmlReport}"`);
+            }
+            catch (e) {
+                console.log(`     ${chalk.red("✖")} Failed to open browser automatically.`);
+                console.log(`     ${chalk.dim(`Manually open: file://${htmlReport}`)}`);
+            }
+        }
+        else if (response.action === "markdown") {
+            console.log(`\n  ${chalk.bold("Generated Markdown Artifacts:")}`);
+            markdownReports.forEach((r) => {
                 const fileName = r.split("/").pop();
-                console.log(` ${chalk.cyan("→")} ${chalk.bold(fileName)} ${chalk.dim(`(${r})`)}`);
+                console.log(`    ${chalk.cyan("•")} ${chalk.bold(fileName)} ${chalk.dim(`(file://${r})`)}`);
             });
-            console.log(chalk.dim("\nTip: Use 'cat' or a Markdown viewer to read the findings."));
+            console.log(`\n  ${chalk.dim("Tip: Click any file:// link above to open directly in your editor.")}\n`);
         }
     }
 }

package/dist/core/ai.js

@@ -18,6 +18,8 @@ export function extractJSON(raw) {
         // Keep only safe whitespace: \n, \r, \t
         return ["\n", "\r", "\t"].includes(match) ? match : "";
     });
+    // Remove single-line comments that are not part of URLs
+    cleaned = cleaned.replace(/(?<!http:|https:)\/\/.*$/gm, "");
     // Find the outermost JSON structure
     const firstBrace = cleaned.indexOf("{");
     const firstBracket = cleaned.indexOf("[");
@@ -36,6 +38,8 @@ export function extractJSON(raw) {
     let snippet = cleaned.substring(start, end + 1);
     // Heuristic: MoE models sometimes miss commas between objects in an array
     snippet = snippet.replace(/\}\s*\{/g, "},{");
+    // Clean trailing commas before closing braces/brackets (which break JSON.parse)
+    snippet = snippet.replace(/,\s*(\}|\])/g, "$1");
     // Heuristic Structural Recovery for Truncated Responses
     const openBraces = (snippet.match(/\{/g) || []).length;
     const closeBraces = (snippet.match(/\}/g) || []).length;
@@ -56,8 +60,15 @@ export function extractJSON(raw) {
  */
 export async function analyzeDiff(diff, fileName) {
     const config = getConfig();
-    if (!config.ai.apiKey || !config.ai.accountId) {
-        throw new Error("Missing AI provider credentials in ~/.pika-review.yaml");
+    const isOllama = config.ai.provider === "ollama";
+    const isCloudflare = config.ai.provider === "cloudflare";
+    // Relax credentials check: Only enforce accountId/apiKey for Cloudflare Workers AI
+    if (isCloudflare && (!config.ai.apiKey || !config.ai.accountId)) {
+        throw new Error("Missing Cloudflare provider credentials (apiKey, accountId) in ~/.pika-review.yaml");
+    }
+    // For standard API providers (OpenAI, DeepSeek, etc.), we only need the apiKey
+    if (!isOllama && !isCloudflare && !config.ai.apiKey) {
+        throw new Error("Missing API Key (apiKey) in ~/.pika-review.yaml");
     }
     // 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.
@@ -68,9 +79,13 @@ export async function analyzeDiff(diff, fileName) {
         : diff;
     const baseURL = config.ai.baseURL && config.ai.baseURL.trim()
         ? config.ai.baseURL
-        : `https://api.cloudflare.com/client/v4/accounts/${config.ai.accountId}/ai/v1`;
+        : (isOllama
+            ? "http://localhost:11434/v1"
+            : (isCloudflare
+                ? `https://api.cloudflare.com/client/v4/accounts/${config.ai.accountId}/ai/v1`
+                : "https://api.openai.com/v1"));
     const openai = new OpenAI({
-        apiKey: config.ai.apiKey,
+        apiKey: config.ai.apiKey || "ollama",
         baseURL,
     });
     // Load custom architecture rules if they exist

package/dist/core/reporter.js

@@ -86,140 +86,266 @@ export function writeHTMLReport(sessionDir, totalFiles, allFindings) {
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Pika Review | ${projectName}</title>
+    <title>Pika Sentinel Report | ${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">
+    <link href="https://fonts.googleapis.com/css2?family=Fira+Code:wght@400;500&family=Outfit:wght@300;400;500;600;700;800&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);
+            --bg: #09090b;
+            --sidebar-bg: #0c0c0e;
+            --card-bg: rgba(255, 255, 255, 0.02);
+            --card-hover: rgba(255, 255, 255, 0.04);
+            --text: #f3f4f6;
+            --text-dim: #a1a1aa;
+            --accent: #00F0FF;
+            --accent-glow: rgba(0, 240, 255, 0.15);
+            --critical: #ef4444;
+            --high: #f97316;
+            --medium: #eab308;
+            --low: #10b981;
+            --border: rgba(255, 255, 255, 0.08);
+            --font-sans: 'Outfit', sans-serif;
+            --font-mono: 'Fira Code', monospace;
         }
 
         * { margin: 0; padding: 0; box-sizing: border-box; }
         body { 
-            font-family: 'Inter', sans-serif; 
+            font-family: var(--font-sans); 
             background: var(--bg); 
             color: var(--text);
             display: flex;
             height: 100vh;
             overflow: hidden;
+            -webkit-font-smoothing: antialiased;
         }
 
-        /* Sidebar */
+        /* Ambient glows and high-tech grid overlays */
+        .bg-grid {
+            position: fixed;
+            top: 0; left: 0; width: 100%; height: 100%;
+            background-image: 
+                linear-gradient(to right, rgba(255,255,255,0.01) 1px, transparent 1px),
+                linear-gradient(to bottom, rgba(255,255,255,0.01) 1px, transparent 1px);
+            background-size: 30px 30px;
+            pointer-events: none;
+            z-index: 1;
+        }
+
+        .bg-radial {
+            position: fixed;
+            top: -10%; right: -10%; width: 60vw; height: 60vw;
+            background: radial-gradient(circle, rgba(0, 240, 255, 0.03) 0%, transparent 70%);
+            pointer-events: none;
+            z-index: 1;
+        }
+
+        /* Sidebar container */
         aside {
-            width: 350px;
+            width: 360px;
             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);
+            box-shadow: 10px 0 40px rgba(0,0,0,0.5);
             z-index: 10;
         }
 
         .brand {
-            padding: 32px 24px;
+            padding: 30px 24px;
             border-bottom: 1px solid var(--border);
-            background: linear-gradient(135deg, rgba(56, 189, 248, 0.1), transparent);
+            display: flex;
+            align-items: center;
+            gap: 16px;
+            background: linear-gradient(180deg, rgba(0, 240, 255, 0.02), transparent);
+        }
+
+        .brand-logo {
+            width: 38px;
+            height: 38px;
+            filter: drop-shadow(0 0 6px rgba(0, 240, 255, 0.5));
+        }
+
+        .brand-text h1 { 
+            font-size: 1.25rem; 
+            font-weight: 800; 
+            letter-spacing: -0.5px; 
+            color: var(--text);
+            display: flex;
+            align-items: center;
+            gap: 8px;
+        }
+        
+        .brand-text h1 span {
+            color: var(--accent);
+            text-shadow: 0 0 10px rgba(0, 240, 255, 0.3);
         }
 
-        .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; }
+        .brand-text p { 
+            font-size: 0.75rem; 
+            color: var(--text-dim); 
+            margin-top: 4px; 
+            font-weight: 500; 
+        }
 
         .sidebar-stats {
             padding: 20px 24px;
             display: grid;
-            grid-template-columns: 1fr 1fr;
-            gap: 12px;
+            grid-template-columns: repeat(3, 1fr);
+            gap: 10px;
             border-bottom: 1px solid var(--border);
         }
 
         .stat-box {
-            background: rgba(255,255,255,0.03);
-            padding: 12px;
-            border-radius: 10px;
-            text-align: center;
+            background: var(--card-bg);
             border: 1px solid var(--border);
+            padding: 12px 6px;
+            border-radius: 8px;
+            text-align: center;
+            transition: all 0.2s ease;
         }
 
-        .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; }
+        .stat-box:hover {
+            border-color: rgba(255, 255, 255, 0.15);
+        }
+
+        .stat-val { 
+            display: block; 
+            font-size: 1.15rem; 
+            font-weight: 800; 
+            color: var(--accent); 
+            text-shadow: 0 0 8px rgba(0, 240, 255, 0.2);
+        }
+        
+        .stat-box.crit-stat .stat-val {
+            color: var(--critical);
+            text-shadow: 0 0 8px rgba(239, 68, 68, 0.2);
+        }
+
+        .stat-lab { 
+            display: block; 
+            font-size: 0.6rem; 
+            font-weight: 700; 
+            text-transform: uppercase; 
+            color: var(--text-dim); 
+            margin-top: 4px; 
+            letter-spacing: 0.05em; 
+        }
 
         .file-list {
             flex: 1;
             overflow-y: auto;
-            padding: 16px;
+            padding: 20px 16px;
         }
 
         .file-item {
             padding: 14px 16px;
-            border-radius: 12px;
+            border-radius: 10px;
             cursor: pointer;
             margin-bottom: 8px;
-            transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+            background: var(--card-bg);
+            border: 1px solid var(--border);
+            transition: all 0.25s cubic-bezier(0.4, 0, 0.2, 1);
             display: flex;
             flex-direction: column;
-            gap: 6px;
-            border: 1px solid transparent;
+            gap: 8px;
+        }
+
+        .file-item:hover { 
+            background: var(--card-hover); 
+            border-color: rgba(0, 240, 255, 0.2); 
+            transform: translateX(4px);
+        }
+
+        .file-item.active { 
+            background: rgba(0, 240, 255, 0.04); 
+            border-color: var(--accent); 
+            box-shadow: 0 0 15px rgba(0, 240, 255, 0.08); 
         }
 
-        .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; }
+        .file-item .name { 
+            font-size: 0.85rem; 
+            font-family: var(--font-mono); 
+            font-weight: 500; 
+            word-break: break-all;
+            color: var(--text-dim);
+            transition: color 0.2s;
+        }
+        
+        .file-item.active .name {
+            color: var(--accent);
+            text-shadow: 0 0 8px rgba(0, 240, 255, 0.4);
+        }
         
         .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; }
+        .pill { 
+            font-size: 0.65rem; 
+            padding: 2px 6px; 
+            border-radius: 4px; 
+            background: rgba(0,0,0,0.3); 
+            font-weight: 700; 
+            border: 1px solid rgba(255,255,255,0.05);
+        }
 
-        /* Main Content */
+        /* Main Content area */
         main {
             flex: 1;
             overflow-y: auto;
-            padding: 60px;
-            background: radial-gradient(circle at top right, rgba(56, 189, 248, 0.05), transparent 40%);
+            padding: 60px 80px;
+            position: relative;
+            z-index: 5;
         }
 
         .content-container { max-width: 900px; margin: 0 auto; }
 
         .page-header {
-            margin-bottom: 50px;
-            animation: fadeInDown 0.5s ease-out;
+            margin-bottom: 40px;
+            animation: fadeInDown 0.4s cubic-bezier(0.16, 1, 0.3, 1);
         }
 
         @keyframes fadeInDown {
-            from { opacity: 0; transform: translateY(-20px); }
+            from { opacity: 0; transform: translateY(-12px); }
             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; }
+        .page-header h2 { 
+            font-size: 1.85rem; 
+            font-family: var(--font-mono); 
+            margin-bottom: 12px; 
+            color: #fff;
+            letter-spacing: -0.5px;
+        }
+        
+        .page-header p { color: var(--text-dim); font-size: 0.95rem; }
 
+        /* Anomaly Findings Cards */
         .issue-card {
             background: var(--card-bg);
             border: 1px solid var(--border);
-            border-radius: 20px;
-            padding: 32px;
-            margin-bottom: 30px;
+            border-radius: 16px;
+            padding: 30px;
+            margin-bottom: 24px;
             position: relative;
-            box-shadow: 0 10px 40px rgba(0,0,0,0.2);
-            transition: transform 0.3s;
+            box-shadow: 0 10px 30px rgba(0,0,0,0.3);
+            transition: all 0.25s cubic-bezier(0.4, 0, 0.2, 1);
+            animation: fadeInUp 0.4s cubic-bezier(0.16, 1, 0.3, 1);
+        }
+
+        @keyframes fadeInUp {
+            from { opacity: 0; transform: translateY(12px); }
+            to { opacity: 1; transform: translateY(0); }
         }
 
-        .issue-card:hover { transform: translateY(-4px); }
+        .issue-card:hover { 
+            transform: translateY(-2px); 
+            border-color: rgba(255, 255, 255, 0.15);
+            box-shadow: 0 15px 35px rgba(0,0,0,0.4);
+        }
 
         .card-accent {
             position: absolute;
-            left: 0; top: 32px; bottom: 32px;
-            width: 5px;
+            left: 0; top: 30px; bottom: 30px;
+            width: 4px;
             border-radius: 0 4px 4px 0;
         }
 
@@ -236,46 +362,89 @@ export function writeHTMLReport(sessionDir, totalFiles, allFindings) {
         }
 
         .severity-tag {
-            font-size: 0.75rem;
+            font-size: 0.7rem;
             text-transform: uppercase;
-            font-weight: 800;
-            padding: 6px 14px;
-            border-radius: 8px;
+            font-weight: 850;
+            padding: 4px 12px;
+            border-radius: 6px;
             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); }
+        .severity-tag.Critical { background: rgba(239, 68, 68, 0.1); color: var(--critical); border: 1px solid rgba(239, 68, 68, 0.2); }
+        .severity-tag.High { background: rgba(249, 115, 22, 0.1); color: var(--high); border: 1px solid rgba(249, 115, 22, 0.2); }
+        .severity-tag.Medium { background: rgba(234, 179, 8, 0.1); color: var(--medium); border: 1px solid rgba(234, 179, 8, 0.2); }
+        .severity-tag.Low { background: rgba(16, 185, 129, 0.1); color: var(--low); border: 1px solid rgba(16, 185, 129, 0.2); }
 
-        .line-info { font-family: 'JetBrains Mono', monospace; color: var(--text-dim); font-size: 0.9rem; }
+        .line-info { font-family: var(--font-mono); color: var(--text-dim); font-size: 0.85rem; }
 
         .field-group { margin-bottom: 24px; }
+        .field-group:last-child { margin-bottom: 0; }
+        
         .field-label {
             font-size: 0.7rem;
             font-weight: 800;
             color: var(--text-dim);
             text-transform: uppercase;
             letter-spacing: 0.1em;
-            margin-bottom: 10px;
+            margin-bottom: 8px;
             display: flex;
             align-items: center;
-            gap: 8px;
+            gap: 6px;
+        }
+
+        .field-content { line-height: 1.6; color: #d1d5db; font-size: 0.95rem; }
+
+        /* Recommendation Pre block with visual copy btn */
+        .pre-wrapper {
+            position: relative;
+            background: #040405;
+            border: 1px solid rgba(255,255,255,0.04);
+            border-radius: 10px;
+            margin-top: 10px;
+            overflow: hidden;
         }
 
-        .field-content { line-height: 1.7; color: #cbd5e1; font-size: 1.05rem; }
+        .pre-header {
+            background: rgba(255,255,255,0.02);
+            border-bottom: 1px solid rgba(255,255,255,0.04);
+            padding: 6px 16px;
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+        }
+
+        .pre-lang {
+            font-size: 0.65rem;
+            font-weight: 700;
+            color: var(--text-dim);
+            text-transform: uppercase;
+        }
+
+        .card-copy-btn {
+            background: none;
+            border: 1px solid rgba(255,255,255,0.08);
+            color: var(--text-dim);
+            font-family: var(--font-sans);
+            font-size: 0.65rem;
+            font-weight: 600;
+            padding: 3px 6px;
+            border-radius: 4px;
+            cursor: pointer;
+            transition: all 0.2s ease;
+        }
+
+        .card-copy-btn:hover {
+            border-color: rgba(0, 240, 255, 0.4);
+            color: var(--accent);
+        }
 
         pre {
-            background: #000;
-            padding: 24px;
-            border-radius: 12px;
-            font-family: 'JetBrains Mono', monospace;
-            font-size: 0.9rem;
-            margin-top: 15px;
+            padding: 16px;
+            font-family: var(--font-mono);
+            font-size: 0.85rem;
+            line-height: 1.5;
             overflow-x: auto;
-            border: 1px solid rgba(255,255,255,0.05);
-            color: #e2e8f0;
+            color: #c7d2fe;
         }
 
         .empty-state {
@@ -285,23 +454,57 @@ export function writeHTMLReport(sessionDir, totalFiles, allFindings) {
             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); }
+        .empty-state svg { 
+            width: 64px; 
+            height: 64px; 
+            margin-bottom: 20px; 
+            stroke: var(--text-dim); 
+            opacity: 0.4;
+            filter: drop-shadow(0 0 8px rgba(0, 240, 255, 0.1));
+        }
+        
+        .empty-state h3 {
+            font-size: 1.25rem;
+            font-weight: 600;
+            margin-bottom: 8px;
+        }
+        
+        .empty-state p {
+            font-size: 0.9rem;
+            color: var(--text-dim);
+            max-width: 320px;
+        }
 
         /* 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 { background: rgba(255,255,255,0.08); border-radius: 10px; }
         ::-webkit-scrollbar-thumb:hover { background: var(--accent); }
     </style>
 </head>
 <body>
+    <div class="bg-grid"></div>
+    <div class="bg-radial"></div>
+
     <aside>
         <div class="brand">
-            <h1>🦊 PIKA REVIEW</h1>
-            <p>${projectName} • ${timestamp}</p>
+            <svg viewBox="0 0 100 100" class="brand-logo" fill="none">
+              <circle cx="50" cy="50" r="44" stroke="#00F0FF" stroke-width="2" stroke-dasharray="4 8" opacity="0.3" />
+              <polygon points="50,42 22,26 34,50" fill="#0c4a6e" stroke="#00F0FF" stroke-width="1.5" stroke-linejoin="round" />
+              <polygon points="50,42 78,26 66,50" fill="#0c4a6e" stroke="#00F0FF" stroke-width="1.5" stroke-linejoin="round" />
+              <polygon points="50,78 20,48 36,48" fill="#0f172a" stroke="#00F0FF" stroke-width="1.5" stroke-linejoin="round" />
+              <polygon points="50,78 80,48 64,48" fill="#0f172a" stroke="#00F0FF" stroke-width="1.5" stroke-linejoin="round" />
+              <polygon points="50,42 36,48 50,78" fill="#1e293b" stroke="#00F0FF" stroke-width="1.5" stroke-linejoin="round" />
+              <polygon points="50,42 64,48 50,78" fill="#1e293b" stroke="#00F0FF" stroke-width="1.5" stroke-linejoin="round" />
+              <polygon points="40,52 46,50 44,56" fill="#00F0FF" />
+              <polygon points="60,52 54,50 56,56" fill="#00F0FF" />
+            </svg>
+            <div class="brand-text">
+                <h1>Pika <span>Sentinel</span></h1>
+                <p>${projectName} • ${timestamp}</p>
+            </div>
         </div>
         <div class="sidebar-stats">
             <div class="stat-box">
@@ -312,6 +515,10 @@ export function writeHTMLReport(sessionDir, totalFiles, allFindings) {
                 <span class="stat-val" id="totalIssues">0</span>
                 <span class="stat-lab">Issues</span>
             </div>
+            <div class="stat-box crit-stat">
+                <span class="stat-val" id="criticalIssues">0</span>
+                <span class="stat-lab">Critical</span>
+            </div>
         </div>
         <div class="file-list" id="fileList"></div>
     </aside>
@@ -319,9 +526,9 @@ export function writeHTMLReport(sessionDir, totalFiles, allFindings) {
     <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>
+                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" 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>
+                <p>Architectural anomalies and security compliance findings will appear here.</p>
             </div>
         </div>
     </main>
@@ -334,6 +541,7 @@ export function writeHTMLReport(sessionDir, totalFiles, allFindings) {
             const mainContent = document.getElementById('mainContent');
             const totalFilesEl = document.getElementById('totalFiles');
             const totalIssuesEl = document.getElementById('totalIssues');
+            const criticalIssuesEl = document.getElementById('criticalIssues');
 
             function escape(str) {
                 if (!str) return '';
@@ -345,9 +553,17 @@ export function writeHTMLReport(sessionDir, totalFiles, allFindings) {
             function init() {
                 totalFilesEl.textContent = findings.length;
                 let issuesCount = 0;
+                let criticalCount = 0;
                 
                 findings.forEach((f, index) => {
                     issuesCount += f.reviews.length;
+                    
+                    f.reviews.forEach(r => {
+                        if (r.severity === 'Critical') {
+                            criticalCount++;
+                        }
+                    });
+
                     const item = document.createElement('div');
                     item.className = 'file-item';
                     
@@ -386,6 +602,7 @@ export function writeHTMLReport(sessionDir, totalFiles, allFindings) {
                 });
 
                 totalIssuesEl.textContent = issuesCount;
+                criticalIssuesEl.textContent = criticalCount;
             }
 
             function selectFile(index, element) {
@@ -420,6 +637,8 @@ export function writeHTMLReport(sessionDir, totalFiles, allFindings) {
                     const card = document.createElement('div');
                     card.className = 'issue-card ' + r.severity;
                     
+                    const escRec = escape(r.recommendation);
+                    
                     card.innerHTML = [
                         '<div class="card-accent"></div>',
                         '<div class="issue-meta">',
@@ -436,7 +655,13 @@ export function writeHTMLReport(sessionDir, totalFiles, allFindings) {
                         '</div>',
                         '<div class="field-group">',
                             '<div class="field-label">🛠️ Recommendation</div>',
-                            '<pre><code>' + escape(r.recommendation) + '</code></pre>',
+                            '<div class="pre-wrapper">',
+                                '<div class="pre-header">',
+                                    '<span class="pre-lang">Code Recommendation</span>',
+                                    '<button class="card-copy-btn" onclick="copyRecommendation(this)">Copy Code</button>',
+                                '</div>',
+                                '<pre><code>' + escRec + '</code></pre>',
+                            '</div>',
                         '</div>'
                     ].join('');
 
@@ -446,6 +671,29 @@ export function writeHTMLReport(sessionDir, totalFiles, allFindings) {
                 mainContent.scrollTop = 0;
             }
 
+            window.copyRecommendation = function(btn) {
+                const preElement = btn.closest('.pre-wrapper').querySelector('pre code');
+                const text = preElement ? preElement.textContent : '';
+
+                // Decode HTML entities before copying
+                const textarea = document.createElement('textarea');
+                textarea.innerHTML = text;
+                const decodedText = textarea.value;
+
+                navigator.clipboard.writeText(decodedText).then(() => {
+                    const originalText = btn.textContent;
+                    btn.textContent = 'Copied! ✓';
+                    btn.style.color = 'var(--accent)';
+                    btn.style.borderColor = 'rgba(0, 240, 255, 0.4)';
+                    
+                    setTimeout(() => {
+                        btn.textContent = originalText;
+                        btn.style.color = '';
+                        btn.style.borderColor = '';
+                    }, 2000);
+                });
+            };
+
             init();
         })();
     </script>

package/dist/core/scanner.js

@@ -2,6 +2,7 @@ import { execFileSync } from "child_process";
 import fs from "fs";
 import cliProgress from "cli-progress";
 import pLimit from "p-limit";
+import chalk from "chalk";
 import { analyzeDiff } from "./ai.js";
 import { setupReportDir, writeMarkdownReport, writeHTMLReport } from "./reporter.js";
 import { getIgnoredFiles } from "../utils/config.js";
@@ -84,13 +85,17 @@ export async function runScan(target, isCI, specificFiles) {
     if (files.length === 0) {
         if (!isCI)
             logger.success("No changes detected. Codebase is clean.");
-        return [];
+        return {
+            markdownReports: [],
+            htmlReport: "",
+            findings: []
+        };
     }
     const reportDir = setupReportDir();
     if (!isCI)
         logger.info(`Initializing Pika Review on ${files.length} file(s)...`);
     const bar = isCI ? null : new cliProgress.SingleBar({
-        format: ' {bar} {percentage}% | ETA: {eta}s | Scanning: {file}',
+        format: '  ' + chalk.cyan('{bar}') + ' ' + chalk.bold('{percentage}%') + ' │ ' + chalk.dim('ETA: {eta}s') + ' │ ' + chalk.gray('{file}'),
         barCompleteChar: '\u2588',
         barIncompleteChar: '\u2591',
         hideCursor: true,
@@ -191,7 +196,10 @@ export async function runScan(target, isCI, specificFiles) {
     const htmlPath = writeHTMLReport(reportDir, files.length, allFindings);
     if (!isCI) {
         logger.success("\nScan complete!");
-        logger.info(`Interactive Report: ${htmlPath}`);
     }
-    return generatedReports;
+    return {
+        markdownReports: generatedReports,
+        htmlReport: htmlPath,
+        findings: allFindings
+    };
 }

package/dist/index.js

@@ -5,6 +5,10 @@ import { initAction } from "./cmd/init.js";
 import { scanAction } from "./cmd/scan.js";
 import { viewAction } from "./cmd/view.js";
 import { statsAction } from "./cmd/stats.js";
+import { modelsAction } from "./cmd/models.js";
+import { hookAction } from "./cmd/hook.js";
+import { rulesAction } from "./cmd/rules.js";
+import { logger } from "./utils/logger.js";
 /**
  * Pika Review: The Enterprise-Grade AI Code Reviewer.
  * Modular entry point for CLI operations.
@@ -12,32 +16,31 @@ import { statsAction } from "./cmd/stats.js";
 const program = new Command();
 // Branding Header
 const BRAND = `
-  ${chalk.bgCyan.black.bold(" PIKA REVIEW ")} ${chalk.dim("v2.0.0 Enterprise")}
-  ${chalk.italic.gray("AI Architectural Sentinel & Compliance Engine")}
+  ${chalk.cyan.bold("◆  Pika Sentinel")}  ${chalk.dim(`v2.2.0 (Enterprise)`)}
+  ${chalk.dim("─".repeat(42))}
+  ${chalk.italic.gray("AI Architectural & Security Safeguard")}
 `;
 const HELPER_TEXT = `
-${chalk.bold.cyan("🚀 Quick Start:")}
-  $ pika-review scan           ${chalk.dim("# Scan staged git changes (default)")}
-  $ 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.cyan.bold("Commands:")}
+    ${chalk.bold("scan")}               Scan git staged changes for issues (default)
+      -u, --unstaged     Scan unstaged changes instead of staged
+      -i, --interactive  Interactively pick files to scan
+      --ci               Fail CI pipeline if critical/high issues are found
+    ${chalk.bold("view")}               Open the latest interactive HTML report in browser
+    ${chalk.bold("stats")}              Print scan history & key quality trends
+    ${chalk.bold("models")}             Interactively select Ollama models for offline audit
+    ${chalk.bold("hook")}               Install Git pre-commit scanner safeguard hook
+    ${chalk.bold("rules")}              AI-generate architectural '.pika-rules.md'
 
-${chalk.bold.cyan("⌨️  Shortcuts & Tips:")}
-  - Use ${chalk.yellow("--ci")} in GitHub Actions to fail on Critical/High issues.
-  - 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:")}
-  - Pika uses ${chalk.green("p-limit(3)")} to scan files in parallel without hitting rate limits.
-  - Real-time progress bars will show you the exact status of each analysis.
+  ${chalk.cyan.bold("Options & Advanced:")}
+    • Custom Rules:   Create a ${chalk.yellow(".pika-rules.md")} to feed custom codebase standards to the AI.
+    • Bypasses:       Add ${chalk.yellow("// pika-ignore")} or ${chalk.yellow("/* pika-ignore */")} in code to skip lines.
+    • Local LLM:      Select an offline model via '${chalk.green("pika-review models")}' for passwordless private runs.
 `;
 program
     .name("pika-review")
     .description("Enterprise-grade AI Architectural Code Reviewer")
-    .version("2.0.0")
+    .version("2.2.0")
     .addHelpText("before", BRAND)
     .addHelpText("after", HELPER_TEXT);
 program
@@ -61,6 +64,38 @@ program
     console.log(BRAND);
     await statsAction();
 });
+program
+    .command("models")
+    .description("Select and configure local Ollama models interactively")
+    .action(async () => {
+    console.log(BRAND);
+    await modelsAction();
+});
+program
+    .command("hook <action>")
+    .description("Install or uninstall Git pre-commit scanner safeguard hook")
+    .addHelpText("after", `\nActions:\n  install      Install Git pre-commit hook\n  uninstall    Remove Git pre-commit hook`)
+    .action(async (action) => {
+    if (action !== "install" && action !== "uninstall") {
+        logger.error("Invalid action. Use 'install' or 'uninstall'.");
+        process.exit(1);
+    }
+    console.log(BRAND);
+    await hookAction(action);
+});
+program
+    .command("rules")
+    .description("AI architectural rules utilities")
+    .option("-g, --generate", "Auto-generate .pika-rules.md based on codebase")
+    .action(async (options) => {
+    console.log(BRAND);
+    if (options.generate) {
+        await rulesAction();
+    }
+    else {
+        logger.info("Use 'pika-review rules --generate' to auto-generate architecture rules.");
+    }
+});
 program
     .command("scan [files...]", { isDefault: true }) // Set scan as the default command
     .description("Scan git changes or specific files for architectural anomalies")

package/dist/utils/config.js

@@ -6,11 +6,12 @@ import { logger } from "./logger.js";
 const CONFIG_PATH = path.join(os.homedir(), ".pika-review.yaml");
 const DEFAULT_CONFIG = {
     ai: {
-        accountId: "", // Account ID if required by provider
+        provider: "openai",
+        accountId: "", // Account ID if required (e.g. Cloudflare)
         apiKey: "",
-        model: "@cf/meta/llama-3-8b-instruct",
+        model: "gpt-4o",
         prompt: "",
-        baseURL: "", // Leave empty for default provider, or set for custom API
+        baseURL: "https://api.openai.com/v1", // Default OpenAI endpoint
     },
 };
 /**
@@ -39,6 +40,19 @@ export function getConfig() {
     }
     return yaml.parse(fs.readFileSync(CONFIG_PATH, "utf-8"));
 }
+/**
+ * Save configuration back to disk with correct permissions.
+ */
+export function saveConfig(config) {
+    try {
+        fs.writeFileSync(CONFIG_PATH, yaml.stringify(config), {
+            mode: 0o600,
+        });
+    }
+    catch (error) {
+        logger.error(`Failed to save configuration: ${error.message}`);
+    }
+}
 /**
  * Get files to ignore during scanning.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pika-review",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Enterprise-grade AI Architectural Code Reviewer.",
   "main": "./dist/index.js",
   "type": "module",