skannr 0.1.1

package/dist/scanner.d.ts

@@ -0,0 +1,16 @@
+/**
+ * File scanner for universal codebases.
+ */
+export declare const DEFAULT_EXCLUDES: string[];
+export interface ScanOptions {
+    extensions?: string[];
+    exclude?: string[];
+    moduleKeys?: string[];
+    moduleDefinitions?: Record<string, string[]>;
+}
+export declare function discoverModules(root: string): string[];
+export declare function scanFiles(rootDir: string, options?: ScanOptions): string[];
+export declare function scanTypeScriptFiles(rootDir: string): string[];
+export declare function scanRocketChatFiles(rootDir: string, moduleKeys?: string[]): string[];
+export declare function readFileContent(filePath: string): string | null;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,eAAO,MAAM,gBAAgB,UAe5B,CAAC;AAoBF,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC9C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBtD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,EAAE,CA4C9E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAE7D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAKpF;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM/D"}

package/dist/scanner.js

@@ -0,0 +1,228 @@
+"use strict";
+/**
+ * File scanner for universal codebases.
+ */
+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 });
+exports.DEFAULT_EXCLUDES = void 0;
+exports.discoverModules = discoverModules;
+exports.scanFiles = scanFiles;
+exports.scanTypeScriptFiles = scanTypeScriptFiles;
+exports.scanRocketChatFiles = scanRocketChatFiles;
+exports.readFileContent = readFileContent;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+exports.DEFAULT_EXCLUDES = [
+    '**/node_modules/**',
+    '**/.git/**',
+    '**/dist/**',
+    '**/build/**',
+    '**/coverage/**',
+    '**/__pycache__/**',
+    '**/*.min.js',
+    '**/*.bundle.js',
+    '**/vendor/**',
+    '**/.next/**',
+    '**/.nuxt/**',
+    '**/target/**',
+    '**/*.pyc',
+    '**/.cache/**',
+];
+const DEFAULT_IGNORED_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    'coverage',
+    '__pycache__',
+    'vendor',
+    '.next',
+    '.nuxt',
+    'target',
+    '.cache',
+    '.idea',
+    '.vscode',
+]);
+const SRC_CANDIDATES = ['src', 'lib', 'packages', 'apps', 'modules'];
+function discoverModules(root) {
+    const srcCandidates = ['src', 'lib', 'packages', 'apps', 'modules'];
+    for (const candidate of srcCandidates) {
+        const candidatePath = path.join(root, candidate);
+        if (fs.existsSync(candidatePath) && fs.statSync(candidatePath).isDirectory()) {
+            const subdirs = fs.readdirSync(candidatePath)
+                .filter((name) => {
+                const fullPath = path.join(candidatePath, name);
+                return fs.statSync(fullPath).isDirectory() && !name.startsWith('.');
+            });
+            if (subdirs.length > 0)
+                return subdirs;
+        }
+    }
+    const ignored = new Set(['node_modules', '.git', 'dist', 'build', 'coverage', '.cache', '__pycache__', 'vendor']);
+    return fs.readdirSync(root)
+        .filter((name) => {
+        const fullPath = path.join(root, name);
+        return fs.statSync(fullPath).isDirectory() && !name.startsWith('.') && !ignored.has(name);
+    });
+}
+function scanFiles(rootDir, options = {}) {
+    const results = [];
+    const excludes = options.exclude ?? exports.DEFAULT_EXCLUDES;
+    const extensions = options.extensions?.map((ext) => ext.toLowerCase());
+    const scanRoots = resolveScanRoots(rootDir, options);
+    const scan = (dir) => {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (shouldExclude(fullPath, rootDir, excludes)) {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                if (!DEFAULT_IGNORED_DIRS.has(entry.name)) {
+                    scan(fullPath);
+                }
+            }
+            else if (entry.isFile()) {
+                if (!extensions || extensions.length === 0) {
+                    results.push(fullPath);
+                    continue;
+                }
+                const ext = path.extname(entry.name).toLowerCase();
+                if (extensions.includes(ext)) {
+                    results.push(fullPath);
+                }
+            }
+        }
+    };
+    for (const scanRoot of scanRoots) {
+        if (fs.existsSync(scanRoot) && fs.statSync(scanRoot).isDirectory()) {
+            scan(scanRoot);
+        }
+    }
+    return Array.from(new Set(results));
+}
+function scanTypeScriptFiles(rootDir) {
+    return scanFiles(rootDir, { extensions: ['.ts', '.tsx'] });
+}
+function scanRocketChatFiles(rootDir, moduleKeys) {
+    return scanFiles(rootDir, {
+        extensions: ['.ts', '.tsx'],
+        moduleKeys,
+    });
+}
+function readFileContent(filePath) {
+    try {
+        return fs.readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+function resolveScanRoots(rootDir, options) {
+    const moduleKeys = options.moduleKeys;
+    const moduleDefinitions = options.moduleDefinitions;
+    if (!moduleKeys || moduleKeys.length === 0) {
+        return [rootDir];
+    }
+    const resolved = [];
+    for (const key of moduleKeys) {
+        if (moduleDefinitions?.[key]) {
+            for (const rel of moduleDefinitions[key]) {
+                const full = path.resolve(rootDir, rel);
+                if (fs.existsSync(full) && fs.statSync(full).isDirectory()) {
+                    resolved.push(full);
+                }
+            }
+            continue;
+        }
+        const direct = path.join(rootDir, key);
+        if (fs.existsSync(direct) && fs.statSync(direct).isDirectory()) {
+            resolved.push(direct);
+            continue;
+        }
+        for (const base of SRC_CANDIDATES) {
+            const candidate = path.join(rootDir, base, key);
+            if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) {
+                resolved.push(candidate);
+            }
+        }
+    }
+    if (resolved.length === 0 && moduleKeys.length > 0) {
+        throw new Error(`No matching modules found for keys: ${moduleKeys.join(', ')}`);
+    }
+    return resolved;
+}
+function shouldExclude(fullPath, rootDir, excludes) {
+    const rel = path.relative(rootDir, fullPath).split(path.sep).join('/');
+    const hasSegment = (segment) => rel === segment || rel.startsWith(`${segment}/`) || rel.includes(`/${segment}/`);
+    for (const pattern of excludes) {
+        if (pattern.includes('node_modules') && hasSegment('node_modules'))
+            return true;
+        if (pattern.includes('.git') && hasSegment('.git'))
+            return true;
+        if (pattern.includes('/dist/') && hasSegment('dist'))
+            return true;
+        if (pattern.includes('/build/') && hasSegment('build'))
+            return true;
+        if (pattern.includes('/coverage/') && hasSegment('coverage'))
+            return true;
+        if (pattern.includes('__pycache__') && hasSegment('__pycache__'))
+            return true;
+        if (pattern.includes('/vendor/') && hasSegment('vendor'))
+            return true;
+        if (pattern.includes('/.next/') && hasSegment('.next'))
+            return true;
+        if (pattern.includes('/.nuxt/') && hasSegment('.nuxt'))
+            return true;
+        if (pattern.includes('/target/') && hasSegment('target'))
+            return true;
+        if (pattern.includes('/.cache/') && hasSegment('.cache'))
+            return true;
+        if (pattern.endsWith('*.min.js') && rel.endsWith('.min.js'))
+            return true;
+        if (pattern.endsWith('*.bundle.js') && rel.endsWith('.bundle.js'))
+            return true;
+        if (pattern.endsWith('*.pyc') && rel.endsWith('.pyc'))
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=scanner.js.map

package/dist/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CH,0CAqBC;AAED,8BA4CC;AAED,kDAEC;AAED,kDAKC;AAED,0CAMC;AAnID,uCAAyB;AACzB,2CAA6B;AAEhB,QAAA,gBAAgB,GAAG;IAC9B,oBAAoB;IACpB,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,gBAAgB;IAChB,mBAAmB;IACnB,aAAa;IACb,gBAAgB;IAChB,cAAc;IACd,aAAa;IACb,aAAa;IACb,cAAc;IACd,UAAU;IACV,cAAc;CACf,CAAC;AAEF,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,cAAc;IACd,MAAM;IACN,MAAM;IACN,OAAO;IACP,UAAU;IACV,aAAa;IACb,QAAQ;IACR,OAAO;IACP,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,SAAS;CACV,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AASrE,SAAgB,eAAe,CAAC,IAAY;IAC1C,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAEpE,KAAK,MAAM,SAAS,IAAI,aAAa,EAAE,CAAC;QACtC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACjD,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YAC7E,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,aAAa,CAAC;iBAC1C,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;gBACf,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;gBAChD,OAAO,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACtE,CAAC,CAAC,CAAC;YACL,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,OAAO,CAAC;QACzC,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;IAClH,OAAO,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC;SACxB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACf,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvC,OAAO,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAgB,SAAS,CAAC,OAAe,EAAE,UAAuB,EAAE;IAClE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,IAAI,wBAAgB,CAAC;IACrD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAErD,MAAM,IAAI,GAAG,CAAC,GAAW,EAAQ,EAAE;QACjC,IAAI,OAAoB,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;gBAC/C,SAAS;YACX,CAAC;YAED,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC1C,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACjB,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1B,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC3C,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACvB,SAAS;gBACX,CAAC;gBACD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;gBACnD,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC7B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YACnE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,SAAgB,mBAAmB,CAAC,OAAe;IACjD,OAAO,SAAS,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,SAAgB,mBAAmB,CAAC,OAAe,EAAE,UAAqB;IACxE,OAAO,SAAS,CAAC,OAAO,EAAE;QACxB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;QAC3B,UAAU;KACX,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,eAAe,CAAC,QAAgB;IAC9C,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe,EAAE,OAAoB;IAC7D,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IACpD,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,iBAAiB,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,KAAK,MAAM,GAAG,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;gBACxC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;oBAC3D,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACvC,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YAC/D,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,SAAS;QACX,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;YAClC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;YAChD,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;gBACrE,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,uCAAuC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB,EAAE,OAAe,EAAE,QAAkB;IAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,CAAC,OAAe,EAAW,EAAE,CAC9C,GAAG,KAAK,OAAO,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,OAAO,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC;IAEnF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,UAAU,CAAC,cAAc,CAAC;YAAE,OAAO,IAAI,CAAC;QAChF,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QAChE,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QAClE,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QACpE,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1E,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC,aAAa,CAAC;YAAE,OAAO,IAAI,CAAC;QAC9E,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QACtE,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QACpE,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QACpE,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QACtE,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QACtE,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,OAAO,IAAI,CAAC;QACzE,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/E,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;IACrE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/skeletonizer.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Language-aware skeleton generation.
+ */
+export declare function buildSkeletonForFile(filePath: string): string;
+//# sourceMappingURL=skeletonizer.d.ts.map

package/dist/skeletonizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeletonizer.d.ts","sourceRoot":"","sources":["../src/skeletonizer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ7D"}

package/dist/skeletonizer.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Language-aware skeleton generation.
+ */
+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 });
+exports.buildSkeletonForFile = buildSkeletonForFile;
+const fs = __importStar(require("fs"));
+const registry_1 = require("./languages/registry");
+function buildSkeletonForFile(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const adapter = (0, registry_1.getAdapter)(filePath);
+        return adapter.generateSkeleton(content, filePath);
+    }
+    catch (error) {
+        return `/* Failed to parse file: ${error instanceof Error ? error.message : 'Unknown error'} */`;
+    }
+}
+//# sourceMappingURL=skeletonizer.js.map

package/dist/skeletonizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeletonizer.js","sourceRoot":"","sources":["../src/skeletonizer.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKH,oDAQC;AAXD,uCAAyB;AACzB,mDAAkD;AAElD,SAAgB,oBAAoB,CAAC,QAAgB;IACnD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,IAAA,qBAAU,EAAC,QAAQ,CAAC,CAAC;QACrC,OAAO,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,KAAK,CAAC;IACnG,CAAC;AACH,CAAC"}

package/dist/tokenizer.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Simple tokenizer for counting approximate tokens in code
+ */
+/**
+ * Count approximate tokens in a string by splitting on whitespace and punctuation
+ * This is a simple heuristic for estimating token count
+ */
+export declare function countTokens(text: string): number;
+//# sourceMappingURL=tokenizer.d.ts.map

package/dist/tokenizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../src/tokenizer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWhD"}

package/dist/tokenizer.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Simple tokenizer for counting approximate tokens in code
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.countTokens = countTokens;
+/**
+ * Count approximate tokens in a string by splitting on whitespace and punctuation
+ * This is a simple heuristic for estimating token count
+ */
+function countTokens(text) {
+    if (!text || text.trim().length === 0) {
+        return 0;
+    }
+    // Split on whitespace, punctuation, and common code delimiters
+    const tokens = text
+        .split(/[\s\n\r\t.,;:!?(){}[\]<>'"/\\|`~@#$%^&*+=-]+/)
+        .filter(token => token.length > 0);
+    return tokens.length;
+}
+//# sourceMappingURL=tokenizer.js.map

package/dist/tokenizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.js","sourceRoot":"","sources":["../src/tokenizer.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAMH,kCAWC;AAfD;;;GAGG;AACH,SAAgB,WAAW,CAAC,IAAY;IACtC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,+DAA+D;IAC/D,MAAM,MAAM,GAAG,IAAI;SAChB,KAAK,CAAC,8CAA8C,CAAC;SACrD,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAErC,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Shared type definitions for skannr
+ */
+/**
+ * Options for analyzing a project
+ */
+export interface AnalyzeOptions {
+    /** Root directory of the project */
+    root: string;
+    /** Natural language question about the codebase */
+    question: string;
+    /** Number of top files to return */
+    limit?: number;
+    /** Generate symbol mapping for on-demand retrieval */
+    generateMapping?: boolean;
+    /** Output path for mapping file (default: <root>/code-analyzer.mapping.json) */
+    mappingOutputPath?: string;
+    /** Use enhanced ranking algorithm with dependency analysis */
+    enhancedRanking?: boolean;
+    /** Optional filter for module keys (e.g. ['auth', 'api']) */
+    moduleKeys?: string[];
+    /** Optional module definitions from config (module -> directory list) */
+    moduleDefinitions?: Record<string, string[]>;
+    /** Optional exclusion globs */
+    exclude?: string[];
+    /** Optional extension allow-list */
+    extensions?: string[];
+    /** Language strategy */
+    lang?: 'typescript' | 'javascript' | 'python' | 'auto';
+}
+/**
+ * Ranked file with relevance score
+ */
+export interface RankedFile {
+    /** Absolute path to the file */
+    path: string;
+    /** Relevance score (0-1) */
+    score: number;
+}
+/**
+ * Analysis result for a single file
+ */
+export interface FileAnalysis {
+    /** Relative path to the file */
+    path: string;
+    /** Relevance score (0-1) */
+    score: number;
+    /** Generated skeleton code */
+    skeleton: string;
+    /** Approximate token count of original file */
+    originalTokenCount: number;
+    /** Approximate token count of skeleton */
+    skeletonTokenCount: number;
+}
+/**
+ * Complete analysis result
+ */
+export interface AnalysisResult {
+    /** The original question */
+    question: string;
+    /** The project root directory */
+    root: string;
+    /** Number of files requested */
+    limit: number;
+    /** Analyzed files with skeletons */
+    files: FileAnalysis[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7C,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,wBAAwB;IACxB,IAAI,CAAC,EAAE,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB"}

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Shared type definitions for skannr
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/gemini-extension/GEMINI.md

@@ -0,0 +1,26 @@
+# Universal Code Analyzer
+
+You have a tool called `scan_codebase` that scans any repository and returns compressed **skeletons** — function signatures and types without the full implementation bodies.
+
+## When to use it
+
+Use `scan_codebase` before reading source files. It tells you which files are relevant and shows their structure without burning tokens on full file contents.
+
+## Parameters
+
+- `question` (**required**): what you want to understand, e.g. `"how are messages sent?"`
+- `root` (**required**): absolute path to the repository, e.g. `/home/user/my-project`
+- `limit`: how many files to return (default: 10)
+- `modules`: narrow the search to specific modules or directories
+
+## Example
+
+```
+scan_codebase({
+  question: "How does the authentication flow work?",
+  root: "/home/user/my-project",
+  modules: ["auth"]
+})
+```
+
+The response includes each file's path, relevance score, skeleton code, and token counts so you can decide what to read in full.

package/gemini-extension/gemini-extension.json

@@ -0,0 +1,12 @@
+{
+  "name": "code-analyzer",
+  "version": "0.1.0",
+  "description": "Analyze any codebase and return token-efficient structural skeletons",
+  "mcpServers": {
+    "code-analyzer": {
+      "command": "node",
+      "args": ["${extensionPath}/dist/server.js"]
+    }
+  },
+  "contextFileName": "GEMINI.md"
+}

package/gemini-extension/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "code-analyzer-extension",
+  "version": "0.1.0",
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  }
+}

package/gemini-extension/src/server.ts

@@ -0,0 +1,63 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { analyzeProject } from '../../dist/index';
+
+const server = new Server(
+  { name: 'code-analyzer', version: '0.1.0' },
+  { capabilities: { tools: {} } }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: 'scan_codebase',
+      description: 'Analyzes any codebase to answer questions about its structure and architecture. Scans files, generates structural skeletons, and ranks results using hybrid retrieval. Supports TypeScript, JavaScript, and Python. Pass the root path of any repository.',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          question: {
+            type: 'string',
+            description: 'What you want to understand about the codebase',
+          },
+          root: {
+            type: 'string',
+            description: 'Absolute path to the repository root',
+          },
+          limit: {
+            type: 'number',
+            description: 'Max number of files to return (default: 10)',
+          },
+          modules: {
+            type: 'array',
+            items: { type: 'string' },
+            description: 'Optional module keys (or directory names) to narrow the search scope',
+          },
+        },
+        required: ['question', 'root'],
+      },
+    },
+  ],
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  if (request.params.name !== 'scan_codebase') {
+    throw new Error(`Unknown tool: ${request.params.name}`);
+  }
+
+  const { question, root, limit = 10, modules } = request.params.arguments as {
+    question: string;
+    root: string;
+    limit?: number;
+    modules?: string[];
+  };
+
+  const result = await analyzeProject({ question, root, limit, moduleKeys: modules });
+
+  return {
+    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+  };
+});
+
+const transport = new StdioServerTransport();
+server.connect(transport).catch(console.error);

package/gemini-extension/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "commonjs",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "moduleResolution": "node",
+    "types": ["node"]
+  },
+  "include": ["src/**/*"]
+}

package/jest.config.js

@@ -0,0 +1,5 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  testMatch: ['**/*.test.ts'],
+};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "skannr",
+  "version": "0.1.1",
+  "description": "A universal tool to analyze any codebase and generate semantic skeletons for AI agents",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "skannr": "dist/cli.js",
+    "skannr-benchmark": "dist/benchmark.js",
+    "skannr-agent": "dist/agent-cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "lint": "eslint src --ext .ts",
+    "start": "npm run build && node dist/cli.js",
+    "cli": "npm run build && node dist/cli.js",
+    "benchmark": "npm run build && node dist/benchmark.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "typescript",
+    "code-analysis",
+    "skeleton",
+    "ast"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@google/generative-ai": "^0.21.0",
+    "ts-morph": "^21.0.1"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.11",
+    "@types/node": "^20.11.0",
+    "@typescript-eslint/eslint-plugin": "^6.19.0",
+    "@typescript-eslint/parser": "^6.19.0",
+    "eslint": "^8.56.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.1",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}