log-search 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 log-search contributors
+
+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,226 @@
+# ⚡ log-search
+
+> **"Search through 50GB log files in under a second"**
+
+A blazing-fast CLI search engine for massive log files. Built on an **Inverted Index** — searches that take `grep` 2 minutes now complete in **0.3 seconds**.
+
+---
+
+## 🚀 Quick Start
+
+```bash
+# First search — builds index automatically
+npx log-search search /var/log/nginx/access.log "ERROR 500"
+
+# Subsequent searches — instant (index reused)
+npx log-search search /var/log/nginx/access.log "ERROR AND timeout"
+
+# Shorthand (no subcommand needed)
+npx log-search access.log "ERROR"
+```
+
+---
+
+## 📦 Installation
+
+```bash
+# Global install
+npm install -g log-search
+
+# Or use directly
+npx log-search --help
+```
+
+**Requirements:** Node.js 18+
+
+---
+
+## 🔍 Query Syntax
+
+| Syntax | Example | Description |
+|--------|---------|-------------|
+| Simple | `error` | Find lines containing "error" |
+| AND | `error AND timeout` | Both terms must appear |
+| OR | `error OR warning` | Either term |
+| NOT | `error NOT 404` | Exclude lines with 404 |
+| Phrase | `"connection refused"` | Exact phrase match |
+| Regex | `/ERROR [45]\d{2}/` | Regular expression |
+| Fuzzy | `~erorr` | Approximate match (Jaro-Winkler) |
+| Level | `level:ERROR` | Match log level field |
+| Field | `status:500` | Match specific field |
+
+---
+
+## 📋 Commands
+
+### `search` — Search a log file
+```bash
+log-search search <file> <query> [options]
+
+Options:
+  -n, --limit <n>          Max results (default: 100)
+  -c, --context <n>        Lines of context around match (default: 0)
+  -r, --regex              Treat query as regex
+  -I, --case-sensitive     Case-sensitive search
+  --json                   JSON output
+  --table                  Table output
+  --rebuild-index          Force index rebuild
+  --since <datetime>       Filter results after this time
+  --until <datetime>       Filter results before this time
+  --level <level>          Filter by log level (ERROR, WARN, INFO...)
+  --sort-by <field>        Sort by: line or score
+```
+
+### `index` — Build index manually
+```bash
+log-search index <file> [--force] [--workers <n>]
+```
+
+### `info` — Show index information
+```bash
+log-search info <file>
+```
+
+### `watch` — Watch file for new content
+```bash
+log-search watch <file> [query] [--alert <pattern>] [--tail <n>]
+```
+
+### `clear` — Delete index files
+```bash
+log-search clear <file>
+log-search clear --all
+```
+
+---
+
+## ⚡ Performance
+
+| File Size | grep (SSD) | log-search (1st run) | log-search (cached) |
+|-----------|-----------|---------------------|---------------------|
+| 1 GB | ~2s | ~8s (build) | **0.05s** |
+| 10 GB | ~20s | ~45s (build) | **0.1s** |
+| 50 GB | ~100s | ~3min (build) | **0.3s** |
+| 100 GB | ~200s | ~6min (build) | **0.5s** |
+
+**How?** Builds an Inverted Index (term → byte offsets). Searches jump directly to matching lines — no full file scan.
+
+---
+
+## 💡 Usage Examples
+
+```bash
+# Basic search
+log-search app.log "ERROR"
+
+# AND search
+log-search app.log "ERROR AND database"
+
+# Regex
+log-search app.log --regex "ERROR [45]\d{2}"
+
+# Time range
+log-search app.log "ERROR" --since "2024-01-01" --until "2024-01-31"
+
+# Context lines
+log-search app.log "FATAL" --context 5
+
+# JSON output for piping
+log-search app.log "ERROR 500" --json | jq '.results[0].content'
+
+# Watch with alert
+log-search watch app.log --alert "FATAL" --tail 20
+
+# Build index first
+log-search index /var/log/nginx/access.log --workers 4
+```
+
+---
+
+## 🏗️ Architecture
+
+```
+log-search/
+├── src/
+│   ├── core/
+│   │   ├── indexer/      ← Inverted index building (parallel workers)
+│   │   ├── searcher/     ← Index-based search + BM25 scoring
+│   │   ├── streaming/    ← Efficient file streaming
+│   │   └── workers/      ← Worker thread pool
+│   ├── index-store/      ← Index registry + LRU cache
+│   ├── formats/          ← Auto-detect + parse Nginx/Apache/JSON/Syslog
+│   ├── query/            ← Full query parser (AND/OR/NOT/regex/fuzzy)
+│   ├── cli/              ← CLI commands + output formatters
+│   └── pro/              ← Pro features (alerts, web UI, license)
+```
+
+**Key algorithm:**
+1. **Index build:** Split file into 64MB chunks → process in parallel workers → merge into single inverted index → compress with gzip → save as `.lsi` file
+2. **Search:** Parse query → look up terms in index → get byte offsets → seek directly to those offsets → fetch line content → score with BM25 → return results
+
+---
+
+## 🔓 Free vs Pro
+
+### Free (MIT)
+- ✅ Unlimited local file search
+- ✅ Full query syntax (AND/OR/NOT/regex/fuzzy)
+- ✅ All log format parsers
+- ✅ Watch mode
+- ✅ JSON/Table output
+- ✅ Programmatic API
+
+### Pro ($12/month)
+- ✅ **Web UI** at `localhost:7777`
+- ✅ **Real-time alerts** → Slack/Discord/PagerDuty/Email/Webhook
+- ✅ **Multi-file search** across directories
+- ✅ **REST API** at `localhost:7778`
+- ✅ **Periodic reports** (daily/weekly error patterns)
+- ✅ Priority support
+
+```bash
+# Activate Pro
+log-search pro activate LSEARCH-XXXX-XXXX-XXXX-XXXX
+
+# Start Web UI
+log-search pro ui
+
+# Start alert engine
+log-search pro alert app.log --rules ./alert-rules.json
+```
+
+---
+
+## 🛠️ Programmatic API
+
+```typescript
+import { IndexBuilder, IndexSearcher } from 'log-search';
+
+// Build index
+const builder = new IndexBuilder('./app.log');
+const result = await builder.build((pct) => console.log(`${pct}%`));
+
+// Search
+const searcher = new IndexSearcher('./app.log');
+await searcher.loadIndex(result.indexPath);
+
+const hits = await searcher.search('ERROR AND timeout', {
+  limit: 100,
+  context: 2,
+  since: '2024-01-01',
+  level: 'ERROR',
+});
+
+console.log(`Found ${hits.length} matches`);
+hits.forEach((h) => console.log(`Line ${h.lineNumber}: ${h.content}`));
+```
+
+---
+
+## 📄 License
+
+MIT — see [LICENSE](./LICENSE)
+
+---
+*TIMSoftDZ*
+*Built for DevOps engineers who are tired of waiting for grep.*

package/bin/log-search.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+
+/**
+ * log-search — Entry Point
+ * Checks Node.js version first, then launches the CLI.
+ * Supports both `log-search` and `lsearch` aliases.
+ */
+
+'use strict';
+
+// ─── Node.js Version Check ────────────────────────────────────────────────────
+const [major] = process.versions.node.split('.').map(Number);
+
+if (major < 18) {
+  console.error(
+    '\x1b[31m[log-search] Error:\x1b[0m Node.js 18+ is required.\n' +
+      `Current version: v${process.versions.node}\n` +
+      'Please upgrade: https://nodejs.org'
+  );
+  process.exit(1);
+}
+
+// ─── Source Map Support (for TypeScript stack traces) ─────────────────────────
+try {
+  require('source-map-support/register');
+} catch (_) {
+  // Source map support is optional — silently ignore if not installed
+}
+
+// ─── Global Error Handlers ────────────────────────────────────────────────────
+process.on('uncaughtException', (err) => {
+  console.error('\x1b[31m[log-search] Uncaught Exception:\x1b[0m', err.message);
+  if (process.env.DEBUG) {
+    console.error(err.stack);
+  }
+  process.exit(1);
+});
+
+process.on('unhandledRejection', (reason) => {
+  console.error('\x1b[31m[log-search] Unhandled Rejection:\x1b[0m', reason);
+  process.exit(1);
+});
+
+// ─── Launch CLI ───────────────────────────────────────────────────────────────
+require('../dist/cli/main');

package/dist/cli/commands/clear.d.ts

@@ -0,0 +1,9 @@
+/**
+ * clear.ts
+ * Delete index files for one or all files.
+ * Usage: log-search clear <file>   — clear index for a specific file
+ *        log-search clear --all    — clear ALL indexes
+ */
+import { Command } from 'commander';
+export declare function createClearCommand(): Command;
+//# sourceMappingURL=clear.d.ts.map

package/dist/cli/commands/clear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/clear.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,kBAAkB,IAAI,OAAO,CAsE5C"}

package/dist/cli/commands/clear.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * clear.ts
+ * Delete index files for one or all files.
+ * Usage: log-search clear <file>   — clear index for a specific file
+ *        log-search clear --all    — clear ALL indexes
+ */
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createClearCommand = createClearCommand;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const fs = __importStar(require("fs"));
+const IndexStore_1 = require("../../index-store/IndexStore");
+const formatter_1 = require("../output/formatter");
+function createClearCommand() {
+    return new commander_1.Command('clear')
+        .alias('c')
+        .description('Delete cached index files')
+        .argument('[file]', 'Path to the log file (optional — omit with --all)')
+        .option('--all', 'Clear ALL cached indexes', false)
+        .option('-y, --yes', 'Skip confirmation prompt', false)
+        .action(async (file, options) => {
+        const store = new IndexStore_1.IndexStore();
+        if (options.all) {
+            const entries = await store.listAll();
+            if (entries.length === 0) {
+                formatter_1.OutputFormatter.printInfo('No indexes found to clear.');
+                return;
+            }
+            console.log(chalk_1.default.bold(`\n  About to delete ${entries.length} index(es):`));
+            for (const e of entries) {
+                console.log(chalk_1.default.dim(`    • ${e.indexPath}`));
+            }
+            console.log('');
+            if (!options.yes) {
+                const { default: inquirer } = await Promise.resolve().then(() => __importStar(require('inquirer')));
+                const { confirm } = await inquirer.prompt([
+                    { type: 'confirm', name: 'confirm', message: 'Delete all indexes?', default: false },
+                ]);
+                if (!confirm) {
+                    formatter_1.OutputFormatter.printInfo('Aborted.');
+                    return;
+                }
+            }
+            let deleted = 0;
+            for (const e of entries) {
+                try {
+                    fs.unlinkSync(e.indexPath);
+                    deleted++;
+                }
+                catch {
+                    // Ignore if already gone
+                }
+                await store.removeEntry(e.filePath);
+            }
+            formatter_1.OutputFormatter.printInfo(`Deleted ${deleted} index file(s).`);
+            return;
+        }
+        // Single file
+        if (!file) {
+            formatter_1.OutputFormatter.printError('Please specify a file or use --all.');
+            process.exit(1);
+        }
+        const indexPath = await store.getIndexPath(file);
+        if (!indexPath) {
+            formatter_1.OutputFormatter.printWarning(`No index found for: ${file}`);
+            return;
+        }
+        try {
+            fs.unlinkSync(indexPath);
+            await store.removeEntry(file);
+            formatter_1.OutputFormatter.printInfo(`Index cleared: ${indexPath}`);
+        }
+        catch (err) {
+            formatter_1.OutputFormatter.printError(`Failed to delete index: ${err}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=clear.js.map

package/dist/cli/commands/clear.js.map

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

package/dist/cli/commands/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * index.ts (CLI command)
+ * Manually build the index for a file without searching.
+ * Usage: log-search index <file> [options]
+ */
+import { Command } from 'commander';
+export declare function createIndexCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,wBAAgB,kBAAkB,IAAI,OAAO,CA4E5C"}

package/dist/cli/commands/index.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * index.ts (CLI command)
+ * Manually build the index for a file without searching.
+ * Usage: log-search index <file> [options]
+ */
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createIndexCommand = createIndexCommand;
+const commander_1 = require("commander");
+const ora_1 = __importDefault(require("ora"));
+const chalk_1 = __importDefault(require("chalk"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const IndexBuilder_1 = require("../../core/indexer/IndexBuilder");
+const IndexStore_1 = require("../../index-store/IndexStore");
+const LogFormatDetector_1 = require("../../formats/LogFormatDetector");
+const formatter_1 = require("../output/formatter");
+function createIndexCommand() {
+    return new commander_1.Command('index')
+        .alias('i')
+        .description('Build (or rebuild) the search index for a log file')
+        .argument('<file>', 'Path to the log file to index')
+        .option('--force', 'Force rebuild even if index exists', false)
+        .option('--chunk-size <mb>', 'Chunk size in MB for parallel processing', '64')
+        .option('--workers <n>', 'Number of parallel worker threads')
+        .action(async (file, options) => {
+        const filePath = path.resolve(file);
+        if (!fs.existsSync(filePath)) {
+            formatter_1.OutputFormatter.printError(`File not found: ${filePath}`);
+            process.exit(1);
+        }
+        const store = new IndexStore_1.IndexStore();
+        const existingIndex = await store.getIndexPath(filePath);
+        if (existingIndex && !options.force) {
+            formatter_1.OutputFormatter.printWarning(`Index already exists for this file. Use --force to rebuild.`);
+            formatter_1.OutputFormatter.printInfo(`Index path: ${existingIndex}`);
+            process.exit(0);
+        }
+        // Detect format
+        const detector = new LogFormatDetector_1.LogFormatDetector();
+        const format = await detector.detect(filePath);
+        formatter_1.OutputFormatter.printInfo(`Detected format: ${chalk_1.default.bold(format)}`);
+        // Build index
+        const chunkSizeMb = parseInt(options.chunkSize, 10);
+        const maxWorkers = options.workers ? parseInt(options.workers, 10) : undefined;
+        const spinner = (0, ora_1.default)({
+            text: chalk_1.default.cyan('Indexing...'),
+            spinner: 'dots',
+        }).start();
+        const t0 = Date.now();
+        try {
+            const builder = new IndexBuilder_1.IndexBuilder(filePath, {
+                chunkSize: chunkSizeMb * 1024 * 1024,
+                maxWorkers,
+            });
+            const result = await builder.build((percent) => {
+                spinner.text = chalk_1.default.cyan(`Indexing... ${percent}%`);
+            });
+            await store.saveIndexPath(filePath, result.indexPath, {
+                totalLines: result.totalLines,
+                fileSize: result.fileSize,
+            });
+            const elapsed = ((Date.now() - t0) / 1000).toFixed(1);
+            spinner.succeed(chalk_1.default.green(`Index built successfully in ${elapsed}s`));
+            console.log('');
+            console.log(chalk_1.default.bold('  Index Stats:'));
+            console.log(chalk_1.default.dim(`    File:          ${filePath}`));
+            console.log(chalk_1.default.dim(`    Index:         ${result.indexPath}`));
+            console.log(chalk_1.default.dim(`    File size:     ${(result.fileSize / 1024 / 1024).toFixed(1)} MB`));
+            console.log(chalk_1.default.dim(`    Total lines:   ${result.totalLines.toLocaleString()}`));
+            console.log(chalk_1.default.dim(`    Unique terms:  ${result.uniqueTerms.toLocaleString()}`));
+            console.log(chalk_1.default.dim(`    Compression:   ${(result.compressionRatio * 100).toFixed(0)}%`));
+            console.log('');
+        }
+        catch (err) {
+            spinner.fail(chalk_1.default.red('Indexing failed'));
+            console.error(err);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/commands/index.js.map

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

package/dist/cli/commands/info.d.ts

@@ -0,0 +1,8 @@
+/**
+ * info.ts
+ * Display detailed info about a file's index.
+ * Usage: log-search info <file>
+ */
+import { Command } from 'commander';
+export declare function createInfoCommand(): Command;
+//# sourceMappingURL=info.d.ts.map

package/dist/cli/commands/info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/info.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,iBAAiB,IAAI,OAAO,CA2C3C"}