context-squeezer-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Erhan Namal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# 🚀 Context-Squeezer
+
+![CI](https://github.com/ErhanNamal/context-squeezer/actions/workflows/ci.yml/badge.svg)
+![npm](https://img.shields.io/badge/npm-friendly-brightgreen)
+
+Lightweight CLI that packs a repository into a single, LLM-optimized context file. Ideal for feeding projects to ChatGPT, Claude, or local LLMs without wasting tokens on irrelevant files.
+
+---
+
+## 🔥 Features
+
+- **Smart Code Squeezing:** Produces a structured, human- and LLM-friendly summary of your codebase.
+- **Automatic Ignore Detection:** Skips common heavy folders and files (`node_modules`, `.git`, `dist`, lockfiles, etc.).
+- **Live Stats & Token Estimation:** Shows total files, lines, characters and an estimated LLM token count.
+- **Custom Output:** Change the output filename or destination with a CLI flag.
+
+---
+
+## 🛠️ Installation
+
+Clone and install dependencies:
+
+```bash
+git clone https://github.com/ErhanNamal/context-squeezer.git
+cd context-squeezer
+npm install
+```
+
+## 🚀 Usage
+
+Squeeze the current project and write the default `ai_context.txt`:
+
+```bash
+npm start
+```
+
+Specify a custom output path:
+
+```bash
+npm start -- --output my_project_summary.txt
+```
+
+## 🖥️ Terminal Dashboard (example)
+
+When run, the CLI prints a compact analytics dashboard similar to the example below:
+
+```
+=============================================
+🚀 CONTEXT-SQUEEZER - AI Context Prepared
+=============================================
+
+🔍 Analyzing directory: D:\Koufc\Yazılım Çalışmaları\Karışık\context-squeezer
+
+📊 PROJECT ANALYTICS REPORT
+---------------------------------------------
+📂 Total Files Compressed  : 5
+📝 Total Lines of Code     : 155
+🔤 Total Character Count   : 4940
+🪙 Estimated LLM Token Load: ~1235 tokens
+---------------------------------------------
+
+✅ Success! Your LLM context file is ready:
+👉 D:\Koufc\Yazılım Çalışmaları\Karışık\context-squeezer\ai_context.txt
+```
+
+## 🤝 Contributing
+
+Contributions are welcome — open issues or pull requests for improvements. Add examples, edge-case handling, or CI workflows to help others use the tool.
+
+## 📝 License
+
+Distributed under the MIT License. See LICENSE for details.

package/bin/context-squeezer.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js';

package/dist/ignorer.js

@@ -0,0 +1,75 @@
+import * as fs from 'fs';
+import * as path from 'path';
+const DEFAULT_IGNORES = [
+    'node_modules',
+    '.git',
+    'package-lock.json',
+    'yarn.lock',
+    'pnpm-lock.yaml',
+    'dist',
+    'build',
+    '.DS_Store'
+];
+// Kuralları çalışma zamanında hafızada tutacak önbellek mekanizması
+let cachedCustomRules = null;
+/**
+ * Projenin kök dizinindeki .aiignore dosyasını sadece bir kez okuyarak belleğe alır.
+ * @param projectRoot Projenin ana çalışma dizini
+ */
+function loadCustomIgnoreRules(projectRoot) {
+    if (cachedCustomRules !== null) {
+        return cachedCustomRules;
+    }
+    const aiIgnorePath = path.join(projectRoot, '.aiignore');
+    if (!fs.existsSync(aiIgnorePath)) {
+        cachedCustomRules = [];
+        return cachedCustomRules;
+    }
+    try {
+        const content = fs.readFileSync(aiIgnorePath, 'utf-8');
+        cachedCustomRules = content
+            .split('\n')
+            .map(line => line.trim())
+            .filter(line => line.length > 0 && !line.startsWith('#'));
+    }
+    catch (err) {
+        cachedCustomRules = [];
+    }
+    return cachedCustomRules;
+}
+/**
+ * Belirtilen dosya yolunun engellenip engellenmeyeceğini kontrol eder.
+ * @param filePath Denetlenecek dosyanın tam yolu
+ * @param projectRoot Projenin ana çalışma dizini
+ */
+export function shouldIgnore(filePath, projectRoot) {
+    // Windows'taki \ işaretlerini / işaretine çevirerek yolları normalize ediyoruz
+    const relativePath = path.relative(projectRoot, filePath).replace(/\\/g, '/');
+    const parts = relativePath.split('/');
+    // 1. Çıktı ve test dosyalarının kendi kendini taramasını engeller
+    const file = path.basename(filePath);
+    if (file.endsWith('.txt') && (file === 'ai_context.txt' || file === 'kodlarim.txt' || file === 'test_output.txt')) {
+        return true;
+    }
+    // 2. Varsayılan global engelleme listesi kontrolü
+    if (parts.some(part => DEFAULT_IGNORES.includes(part))) {
+        return true;
+    }
+    // 3. Kullanıcı tanımlı .aiignore kurallarının kontrolü
+    const customRules = loadCustomIgnoreRules(projectRoot);
+    for (const rule of customRules) {
+        // .aiignore içindeki olası Windows yollarını da normalize et
+        const normalizedRule = rule.replace(/\\/g, '/');
+        if (normalizedRule.startsWith('*.')) {
+            const ext = normalizedRule.slice(1); // Örn: .json uzantısını yakalar
+            if (filePath.endsWith(ext))
+                return true;
+        }
+        else if (relativePath === normalizedRule ||
+            parts.includes(normalizedRule) ||
+            relativePath.startsWith(normalizedRule + '/')) {
+            return true;
+        }
+    }
+    return false;
+}

package/dist/index.js

@@ -0,0 +1,54 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { packProject } from './packager.js';
+function printHelp() {
+    console.log(`
+Context-Squeezer - usage
+
+Options:
+  -h, --help          Show this help message
+  -o, --output <file> Write output to <file> (default: ai_context.txt)
+
+Examples:
+  npm start -- --output my_context.txt
+`);
+}
+function main() {
+    const args = process.argv.slice(2);
+    if (args.includes('-h') || args.includes('--help')) {
+        printHelp();
+        return;
+    }
+    let outputFileName = 'ai_context.txt';
+    const oIndex = args.findIndex(a => a === '-o' || a === '--output');
+    if (oIndex !== -1 && args[oIndex + 1]) {
+        outputFileName = args[oIndex + 1];
+    }
+    const targetDir = process.cwd();
+    console.log('\n=============================================');
+    console.log('🚀 CONTEXT-SQUEEZER - AI Context Prepared');
+    console.log('=============================================\n');
+    console.log(`🔍 Analyzing directory: ${targetDir}`);
+    try {
+        const { combinedContent, stats } = packProject(targetDir);
+        const outputPath = path.isAbsolute(outputFileName)
+            ? outputFileName
+            : path.join(targetDir, outputFileName);
+        fs.writeFileSync(outputPath, combinedContent, 'utf-8');
+        console.log('\n📊 PROJECT ANALYTICS REPORT');
+        console.log('---------------------------------------------');
+        console.log(`📂 Total Files Compressed  : ${stats.totalFiles}`);
+        console.log(`📝 Total Lines of Code     : ${stats.totalLines}`);
+        console.log(`🔤 Total Character Count   : ${stats.totalChars}`);
+        console.log(`🪙 Estimated LLM Token Load: ~${stats.estimatedTokens} tokens`);
+        console.log('---------------------------------------------');
+        console.log(`\n✅ Success! Your LLM context file is ready:`);
+        console.log(`👉 ${outputPath}\n`);
+    }
+    catch (err) {
+        console.error('❌ An error occurred while building the context file:');
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+}
+main();

package/dist/packager.js

@@ -0,0 +1,108 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { shouldIgnore } from './ignorer.js';
+// Güvenli işleme için maksimum dosya boyutu sınırı (Örn: 500 KB)
+const MAX_FILE_SIZE_BYTES = 500 * 1024;
+/**
+ * Bir dosyanın ikili (binary) olup olmadığını ilk byte bloklarını tarayarak kontrol eder.
+ * @param filePath Denetlenecek dosyanın tam yolu
+ */
+function isBinaryFile(filePath) {
+    const buffer = Buffer.alloc(512);
+    let fd = null;
+    try {
+        fd = fs.openSync(filePath, 'r');
+        const bytesRead = fs.readSync(fd, buffer, 0, 512, 0);
+        for (let i = 0; i < bytesRead; i++) {
+            // Null karakteri (\0) kontrolü ikili dosyaları tespit etmek için en güvenli yöntemdir
+            if (buffer[i] === 0) {
+                return true;
+            }
+        }
+        return false;
+    }
+    catch (err) {
+        return true; // Okuma hatası durumunda güvenli tarafta kalmak için binary kabul edilir
+    }
+    finally {
+        if (fd !== null) {
+            fs.closeSync(fd);
+        }
+    }
+}
+/**
+ * Kod içindeki hassas şifre, token ve API anahtarlarını sansürler
+ */
+function maskSensitiveData(content) {
+    const sensitivePatterns = [
+        /(secret[-_]?key|api[-_]?key|password|passwd|auth[-_]?token|client[-_]?secret)\s*[:=]\s*['"`][^'"`]{4,200}['"`]/gi,
+        /AIzaSy[A-Za-z0-9-_]{33}/g,
+        /sk-[a-zA-Z0-9]{48}/g
+    ];
+    let maskedContent = content;
+    for (const pattern of sensitivePatterns) {
+        maskedContent = maskedContent.replace(pattern, (match) => {
+            if (match.includes('=') || match.includes(':')) {
+                const separator = match.includes('=') ? '=' : ':';
+                const parts = match.split(separator);
+                return `${parts[0]}${separator} "[REDACTED BY CONTEXT-SQUEEZER]"`;
+            }
+            return "[REDACTED BY CONTEXT-SQUEEZER]";
+        });
+    }
+    return maskedContent;
+}
+export function packProject(dirPath) {
+    let combinedContent = '';
+    const stats = {
+        totalFiles: 0,
+        totalLines: 0,
+        totalChars: 0,
+        estimatedTokens: 0
+    };
+    function scan(currentDir) {
+        const files = fs.readdirSync(currentDir);
+        for (const file of files) {
+            const fullPath = path.join(currentDir, file);
+            const stat = fs.statSync(fullPath);
+            if (shouldIgnore(fullPath, dirPath)) {
+                continue;
+            }
+            if (stat.isDirectory()) {
+                scan(fullPath);
+            }
+            else if (stat.isFile()) {
+                const relativePath = path.relative(dirPath, fullPath);
+                // Çıktı ve test dosyalarının kendi kendini taramasını engeller
+                if (file.endsWith('.txt') && (file === 'ai_context.txt' || file === 'kodlarim.txt' || file === 'test_output.txt')) {
+                    continue;
+                }
+                // PERFORMANS & GÜVENLİK: Belirlenen boyuttan büyük dosyaları atlar
+                if (stat.size > MAX_FILE_SIZE_BYTES) {
+                    console.warn(`⚠️ Skipped large file (over 500KB): ${relativePath}`);
+                    continue;
+                }
+                // GÜVENLİK: İkili (Resim, PDF, Derlenmiş Dosya vb.) içerikleri filtreler
+                if (isBinaryFile(fullPath)) {
+                    continue;
+                }
+                try {
+                    const content = fs.readFileSync(fullPath, 'utf-8');
+                    const safeContent = maskSensitiveData(content);
+                    stats.totalFiles += 1;
+                    stats.totalLines += safeContent.split('\n').length;
+                    stats.totalChars += safeContent.length;
+                    combinedContent += `\n--- START OF FILE: ${relativePath} ---\n`;
+                    combinedContent += safeContent;
+                    combinedContent += `\n--- END OF FILE: ${relativePath} ---\n`;
+                }
+                catch (e) {
+                    // Okunamayan dosyaları es geç
+                }
+            }
+        }
+    }
+    scan(dirPath);
+    stats.estimatedTokens = Math.ceil(stats.totalChars / 4);
+    return { combinedContent, stats };
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "context-squeezer-cli",
+  "version": "1.0.0",
+  "description": "Lightweight CLI that packs a repository into a single, LLM-optimized context file.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "context-squeezer": "bin/context-squeezer.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "tsc && node ./dist/index.js",
+    "test": "node ./scripts/run-tests.js"
+  },
+  "keywords": [
+    "cli",
+    "llm",
+    "context",
+    "tokenizer",
+    "ai",
+    "devtools"
+  ],
+  "author": "Erhan Namal",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ErhanNamal/context-squeezer.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ErhanNamal/context-squeezer/issues"
+  },
+  "homepage": "https://github.com/ErhanNamal/context-squeezer#readme",
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3"
+  }
+}