skannr 0.1.1

package/.eslintrc.js

@@ -0,0 +1,22 @@
+module.exports = {
+  parser: '@typescript-eslint/parser',
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+  ],
+  parserOptions: {
+    ecmaVersion: 2022,
+    sourceType: 'module',
+  },
+  env: {
+    node: true,
+    es6: true,
+    jest: true,
+  },
+  rules: {
+    '@typescript-eslint/explicit-function-return-type': 'off',
+    '@typescript-eslint/no-explicit-any': 'warn',
+    '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+    'no-console': 'off',
+  },
+};

package/README.md

@@ -0,0 +1,109 @@
+# Skannr
+
+A CLI tool and MCP server that helps AI agents understand **any codebase**.
+It scans files, generates compressed structural "skeletons", and ranks results
+using hybrid retrieval — reducing token usage by ~96% vs full file scans.
+
+## How It Works
+
+1. You point it at any repo with `--root /path/to/repo`
+2. It auto-detects the language (TypeScript, JavaScript, Python, or generic fallback)
+3. It auto-discovers your project's modules from the folder structure
+4. For your question, it ranks the most relevant files using lexical + structural + dependency-graph analysis
+5. It strips function bodies from files (keeping types, signatures, imports)
+6. Returns compact skeletons an AI can reason over without blowing the context window
+
+## Install
+
+```bash
+npm install -g skannr
+```
+
+## Usage
+
+### CLI
+
+```bash
+# Basic
+skannr --question "how does authentication work?" --root /path/to/any/repo
+
+# Limit results
+skannr --question "database connection setup" --root . --limit 5
+
+# Focus on specific modules (auto-discovered if not specified)
+skannr --question "permission checks" --root . --modules auth,middleware
+
+# Force language
+skannr --question "class structure" --root /path/to/python/project --lang python
+
+# Interactive agent mode
+skannr-agent --root /path/to/repo
+
+# Cache management
+skannr --cache-stats
+skannr --cache-clear
+skannr --question "..." --skip-cache
+```
+
+### MCP Server (use with Gemini CLI, Claude Code, Cursor, etc.)
+
+```json
+{
+  "mcpServers": {
+    "skannr": {
+      "command": "npx",
+      "args": ["skannr"]
+    }
+  }
+}
+```
+
+### Config File (optional)
+
+Drop a `code-analyzer.config.json` in your repo root:
+
+```json
+{
+  "modules": {
+    "auth": ["src/auth", "lib/auth"],
+    "api": ["src/api", "src/routes"]
+  },
+  "exclude": ["**/generated/**", "**/migrations/**"],
+  "extensions": [".ts", ".js"],
+  "defaultLimit": 10
+}
+```
+
+## Supported Languages
+
+| Language | Skeleton Support |
+|---|---|
+| TypeScript / TSX | Full AST (ts-morph) |
+| JavaScript / JSX | Full AST (ts-morph) |
+| Python | Regex-based (signatures + types) |
+| Others | First 50 lines (generic fallback) |
+
+## Performance
+
+Benchmarked on large TypeScript monorepo:
+
+| Metric | Result |
+|---|---|
+| Token Reduction vs Full Scan | ~96.5% |
+| Token Reduction vs Top-N | ~78.2% |
+| Avg keyword coverage | ~75% |
+| Directory diversity (top-5) | ~80% |
+| Average execution time | ~1.2s |
+
+## Interactive Agent Commands
+
+```
+/help              Show all commands
+/files             List retrieved files
+/symbols <query>   Search for symbols
+/symbol <id>       Get full implementation
+/deps <file>       Show imports for a file
+/refresh           Re-analyze with new context
+/stats             Show mapping statistics
+/exit              Quit
+```

package/dist/agent-cli.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Agent CLI - Interactive code analysis with Gemini AI
+ * This demonstrates the agentic code analysis workflow
+ */
+export {};
+//# sourceMappingURL=agent-cli.d.ts.map

package/dist/agent-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-cli.d.ts","sourceRoot":"","sources":["../src/agent-cli.ts"],"names":[],"mappings":";AAEA;;;GAGG"}

package/dist/agent-cli.js

@@ -0,0 +1,364 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Agent CLI - Interactive code analysis with Gemini AI
+ * This demonstrates the agentic code analysis workflow
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const agent_1 = require("./agent");
+const index_1 = require("./index");
+const readline = __importStar(require("readline"));
+const path = __importStar(require("path"));
+function buildSkeletonContext(result, includeScores) {
+    return result.files
+        .map((file) => {
+        if (includeScores) {
+            return `=== ${file.path} (score: ${file.score.toFixed(2)}) ===\n${file.skeleton}`;
+        }
+        return `=== ${file.path} ===\n${file.skeleton}`;
+    })
+        .join('\n\n');
+}
+function printEvidence(result) {
+    console.log('📚 Retrieval Evidence:');
+    for (const file of result.files.slice(0, 10)) {
+        console.log(`- ${file.path} (score: ${file.score.toFixed(2)})`);
+    }
+    console.log('');
+}
+function printInteractiveHelp() {
+    console.log('Commands:');
+    console.log('  /help                 Show this help');
+    console.log('  /files                List currently retrieved files');
+    console.log('  /symbols <query>      Search symbols in loaded mapping');
+    console.log('  /symbol <symbolId>    Show full implementation for a symbol');
+    console.log('  /deps <filePath>      Show imports and symbols for a file');
+    console.log('  /refresh              Re-analyze project and refresh context');
+    console.log('  /stats                Show mapping statistics');
+    console.log('  /exit                 Quit interactive mode');
+    console.log('');
+}
+/**
+ * Parse command line arguments
+ */
+function parseArgs() {
+    const args = process.argv.slice(2);
+    let root = process.cwd();
+    let question = '';
+    let limit = 10;
+    let apiKey = process.env.GEMINI_API_KEY;
+    let model = 'gemini-2.0-flash-exp';
+    let interactive = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--root' && i + 1 < args.length) {
+            root = args[i + 1];
+            i++;
+        }
+        else if (arg === '--question' && i + 1 < args.length) {
+            question = args[i + 1];
+            i++;
+        }
+        else if (arg === '--limit' && i + 1 < args.length) {
+            limit = parseInt(args[i + 1], 10);
+            if (isNaN(limit) || limit < 1) {
+                console.error('Error: --limit must be a positive number');
+                return null;
+            }
+            i++;
+        }
+        else if (arg === '--api-key' && i + 1 < args.length) {
+            apiKey = args[i + 1];
+            i++;
+        }
+        else if (arg === '--model' && i + 1 < args.length) {
+            model = args[i + 1];
+            i++;
+        }
+        else if (arg === '--interactive' || arg === '-i') {
+            interactive = true;
+        }
+        else if (arg === '--help' || arg === '-h') {
+            printHelp();
+            return null;
+        }
+        else {
+            console.error(`Unknown argument: ${arg}`);
+            printHelp();
+            return null;
+        }
+    }
+    if (!apiKey) {
+        console.error('Error: GEMINI_API_KEY environment variable or --api-key is required\n');
+        return null;
+    }
+    if (!question && !interactive) {
+        console.error('Error: --question is required (or use --interactive for chat mode)\n');
+        printHelp();
+        return null;
+    }
+    return { root, question, limit, apiKey, model, interactive };
+}
+/**
+ * Print help message
+ */
+function printHelp() {
+    console.log(`
+uca-agent - AI-Powered Code Analysis Agent
+
+Usage:
+  uca-agent --question "<text>" [options]
+  uca-agent --interactive [options]
+
+Options:
+  --root <path>        Project root directory (default: current directory)
+  --question "<text>"  Question to analyze (required unless --interactive)
+  --limit <number>     Number of top files to analyze (default: 10)
+  --api-key <key>      Gemini API key (or set GEMINI_API_KEY env var)
+  --model <name>       Gemini model name (default: gemini-2.0-flash-exp)
+  --interactive, -i    Start interactive chat mode
+  --help, -h           Show this help message
+
+Example:
+  uca-agent --question "How does authentication work?"
+  uca-agent --interactive --root ./my-project
+  uca-agent --question "Find all API endpoints" --limit 15
+
+Environment Variables:
+  GEMINI_API_KEY       Gemini API key (alternative to --api-key)
+  `);
+}
+/**
+ * Run single question mode
+ */
+async function runSingleQuestion(args) {
+    console.log('🔍 Analyzing codebase...\n');
+    // Step 1: Generate skeletons with mapping
+    const result = await (0, index_1.analyzeProject)({
+        root: args.root,
+        question: args.question,
+        limit: args.limit,
+        generateMapping: true,
+    });
+    if (result.files.length === 0) {
+        console.log('No files found for analysis.');
+        return;
+    }
+    console.log(`📊 Found ${result.files.length} relevant files\n`);
+    // Prepare skeleton context
+    const skeletonContext = buildSkeletonContext(result, true);
+    // Step 2: Create agent and load mapping
+    const agent = (0, agent_1.createCodeAnalysisAgent)(args.apiKey, args.model);
+    const mappingPath = path.join(result.root, 'code-analyzer.mapping.json');
+    agent.loadMapping(mappingPath);
+    const stats = agent.getStats();
+    console.log(`📝 Loaded mapping: ${stats.totalFiles} files, ${stats.totalSymbols} symbols\n`);
+    console.log(`🤖 Agent is analyzing...\n`);
+    // Step 3: Send to agent
+    const response = await agent.chat(args.question, skeletonContext);
+    console.log('📋 Agent Response:\n');
+    console.log(response);
+    console.log('\n');
+    printEvidence(result);
+}
+/**
+ * Run interactive mode
+ */
+async function runInteractive(args) {
+    console.log('🚀 Starting interactive code analysis agent...\n');
+    console.log('First, let me analyze your codebase.\n');
+    const buildState = async () => {
+        const result = await (0, index_1.analyzeProject)({
+            root: args.root,
+            question: 'code structure and organization',
+            limit: args.limit,
+            generateMapping: true,
+        });
+        if (result.files.length === 0) {
+            return {
+                result,
+                skeletonContext: '',
+            };
+        }
+        return {
+            result,
+            skeletonContext: buildSkeletonContext(result, false),
+        };
+    };
+    // Step 1: Generate skeletons with mapping
+    let state = await buildState();
+    if (state.result.files.length === 0) {
+        console.log('No files found for analysis.');
+        return;
+    }
+    console.log(`📊 Analyzed ${state.result.files.length} files\n`);
+    // Step 2: Create agent and load mapping
+    const agent = (0, agent_1.createCodeAnalysisAgent)(args.apiKey, args.model);
+    const mappingPath = path.join(state.result.root, 'code-analyzer.mapping.json');
+    agent.loadMapping(mappingPath);
+    const stats = agent.getStats();
+    console.log(`📝 Mapping: ${stats.totalFiles} files, ${stats.totalSymbols} symbols\n`);
+    console.log('💬 Ready for questions! Type /help for commands.\n');
+    // Step 3: Interactive loop
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const askQuestion = () => {
+        rl.question('You: ', async (input) => {
+            const question = input.trim();
+            if (question.toLowerCase() === 'exit' || question.toLowerCase() === '/exit') {
+                console.log('\n👋 Goodbye!');
+                rl.close();
+                return;
+            }
+            if (question.toLowerCase() === 'stats' || question.toLowerCase() === '/stats') {
+                console.log('\n📊 Statistics:');
+                console.log(JSON.stringify(agent.getStats(), null, 2));
+                console.log('');
+                askQuestion();
+                return;
+            }
+            if (question.toLowerCase() === '/help') {
+                console.log('');
+                printInteractiveHelp();
+                askQuestion();
+                return;
+            }
+            if (question.toLowerCase() === '/files') {
+                console.log('');
+                printEvidence(state.result);
+                askQuestion();
+                return;
+            }
+            if (question.toLowerCase() === '/refresh') {
+                console.log('\n🔄 Refreshing project analysis...');
+                state = await buildState();
+                const refreshedMappingPath = path.join(state.result.root, 'code-analyzer.mapping.json');
+                agent.loadMapping(refreshedMappingPath);
+                console.log(`✅ Refreshed ${state.result.files.length} files\n`);
+                askQuestion();
+                return;
+            }
+            if (question.startsWith('/symbols ')) {
+                const query = question.slice('/symbols '.length).trim();
+                if (!query) {
+                    console.log('\nUsage: /symbols <query>\n');
+                    askQuestion();
+                    return;
+                }
+                const symbols = agent.searchSymbols(query);
+                console.log('\n🔎 Symbol Search Result:');
+                console.log(JSON.stringify(symbols, null, 2));
+                console.log('');
+                askQuestion();
+                return;
+            }
+            if (question.startsWith('/symbol ')) {
+                const symbolId = question.slice('/symbol '.length).trim();
+                if (!symbolId) {
+                    console.log('\nUsage: /symbol <symbolId>\n');
+                    askQuestion();
+                    return;
+                }
+                const symbol = agent.getSymbolDetails(symbolId);
+                console.log('\n🧩 Symbol Details:');
+                console.log(JSON.stringify(symbol, null, 2));
+                console.log('');
+                askQuestion();
+                return;
+            }
+            if (question.startsWith('/deps ')) {
+                const filePath = question.slice('/deps '.length).trim();
+                if (!filePath) {
+                    console.log('\nUsage: /deps <filePath>\n');
+                    askQuestion();
+                    return;
+                }
+                const deps = agent.analyzeFileDependencies(filePath);
+                console.log('\n🕸️ File Dependencies:');
+                console.log(JSON.stringify(deps, null, 2));
+                console.log('');
+                askQuestion();
+                return;
+            }
+            if (!question) {
+                askQuestion();
+                return;
+            }
+            console.log('\n🤖 Agent: ');
+            try {
+                const response = await agent.chat(question, state.skeletonContext);
+                console.log(response);
+                console.log('');
+                printEvidence(state.result);
+            }
+            catch (error) {
+                console.error('Error:', error instanceof Error ? error.message : error);
+            }
+            console.log('');
+            askQuestion();
+        });
+    };
+    askQuestion();
+}
+/**
+ * Main CLI function
+ */
+async function main() {
+    const args = parseArgs();
+    if (!args) {
+        process.exit(1);
+    }
+    try {
+        if (args.interactive) {
+            await runInteractive(args);
+        }
+        else {
+            await runSingleQuestion(args);
+        }
+    }
+    catch (error) {
+        console.error('Error:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+// Run CLI
+main().catch((error) => {
+    console.error('Unexpected error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=agent-cli.js.map

package/dist/agent-cli.js.map

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

package/dist/agent.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Gemini AI Agent Integration for Code Analysis
+ * This module provides tool definitions and agent setup for agentic code analysis
+ */
+import { SchemaType } from '@google/generative-ai';
+/**
+ * Tool definition for getting symbol details
+ */
+export declare const getSymbolDetailsTool: {
+    name: string;
+    description: string;
+    parameters: {
+        type: SchemaType;
+        properties: {
+            symbolId: {
+                type: SchemaType;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * Tool definition for searching code symbols
+ */
+export declare const searchSymbolsTool: {
+    name: string;
+    description: string;
+    parameters: {
+        type: SchemaType;
+        properties: {
+            query: {
+                type: SchemaType;
+                description: string;
+            };
+            symbolType: {
+                type: SchemaType;
+                description: string;
+                enum: string[];
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * Tool definition for analyzing file dependencies
+ */
+export declare const analyzeFileDependenciesTool: {
+    name: string;
+    description: string;
+    parameters: {
+        type: SchemaType;
+        properties: {
+            filePath: {
+                type: SchemaType;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * Code Analysis Agent
+ */
+export declare class CodeAnalysisAgent {
+    private genAI;
+    private mapping;
+    private model;
+    constructor(apiKey: string, modelName?: string);
+    /**
+     * Load symbol mapping
+     */
+    loadMapping(mappingPath: string): void;
+    /**
+     * Handle tool calls from the model
+     */
+    private handleToolCall;
+    /**
+     * Get symbol details
+     */
+    private handleGetSymbolDetails;
+    /**
+     * Search symbols
+     */
+    private handleSearchSymbols;
+    /**
+     * Analyze file dependencies
+     */
+    private handleAnalyzeFileDependencies;
+    /**
+     * Start a conversation with the agent
+     */
+    chat(userMessage: string, skeletonContext?: string): Promise<string>;
+    /**
+     * Local wrapper for symbol search without model invocation.
+     */
+    searchSymbols(query: string, symbolType?: string): any;
+    /**
+     * Local wrapper for fetching symbol implementation by ID.
+     */
+    getSymbolDetails(symbolId: string): any;
+    /**
+     * Local wrapper for file dependency analysis.
+     */
+    analyzeFileDependencies(filePath: string): any;
+    /**
+     * Get statistics about the loaded mapping
+     */
+    getStats(): any;
+}
+/**
+ * Helper function to create an agent instance
+ */
+export declare function createCodeAnalysisAgent(apiKey: string, modelName?: string): CodeAnalysisAgent;
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAsB,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAKvE;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;CAehC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;CAmB7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;CAcvC,CAAC;AAEF;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,KAAK,CAAM;gBAEP,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,MAA+B;IAgBtE;;OAEG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAQtC;;OAEG;YACW,cAAc;IAkB5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwC3B;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAqCrC;;OAEG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiD1E;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,GAAG;IAItD;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG;IAIvC;;OAEG;IACH,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG;IAI9C;;OAEG;IACH,QAAQ,IAAI,GAAG;CAuBhB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAE7F"}