lightning-code-index 0.0.0__tar.gz

lightning_code_index-0.0.0/.gitignore

@@ -0,0 +1,93 @@
+# Build artifacts
+/lci
+/lci-*
+/lci-binary
+cmd/lci/lci
+cmd/lci/lci-*
+debug_treesitter
+*.log
+/debug*.go
+!internal/debug/
+*.exe
+*.dll
+*.so
+*.dylib
+
+# Go build cache
+.cache/
+
+# Test coverage
+coverage.out
+*.test
+
+# Profiling files
+*.prof
+/profile_*
+!cmd/profile_*/
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Local development
+.env
+.env.local
+
+# Go-specific patterns
+vendor/
+*.out
+# *.mod and *.sum should NOT be ignored - they are required for Go modules
+# Remove these lines if they were added incorrectly
+
+# Go test artifacts
+*.cover
+coverage.html
+coverage-mcp-*.html
+
+# Test helper artifacts
+testhelpers/test-logs/
+testhelpers/*_report.json
+testdata/perf-*.json
+testdata/bench-*.json
+
+# Go workspace files
+go.work
+go.work.sum
+
+# Air live reload
+.air.toml
+tmp/
+
+# Temporary files
+*.tmp
+*.temp
+*.bak
+*.backup
+
+# Large test fixture projects (323MB total - causes indexing stalls)
+**/workflow_testdata/
+
+# Real-world test projects (cloned via scripts/setup_test_projects.sh)
+# These are pinned to specific commits for reproducible testing
+real_projects/go/
+real_projects/python/
+real_projects/typescript/
+
+# Only exclude actual build artifact documentation, not general docs
+# docs/*_ANALYSIS_BUILD.md
+# docs/*_OPTIMIZATION_BUILD.md
+# Remove overly broad patterns - they exclude valid documentation!
+testing/qualitative/output/
+
+# npm distribution artifacts
+*.tgz
+dist/
+node_modules/
+build-report.txt

lightning_code_index-0.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Standard Beagle
+
+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.

lightning_code_index-0.0.0/PKG-INFO

@@ -0,0 +1,229 @@
+Metadata-Version: 2.4
+Name: lightning-code-index
+Version: 0.0.0
+Summary: Lightning Code Index - Sub-millisecond semantic code search and analysis
+Project-URL: Homepage, https://github.com/standardbeagle/lci
+Project-URL: Repository, https://github.com/standardbeagle/lci
+Project-URL: Issues, https://github.com/standardbeagle/lci/issues
+Author: Standard Beagle
+License-Expression: MIT
+License-File: LICENSE
+Keywords: code-analysis,code-search,indexing,mcp,semantic-search
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Text Processing :: Indexing
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# LCI - Lightning Code Index
+
+Lightning-fast code indexing and search for AI assistants.
+
+[![CI](https://github.com/standardbeagle/lci/actions/workflows/ci.yml/badge.svg)](https://github.com/standardbeagle/lci/actions/workflows/ci.yml)
+[![Go Report Card](https://goreportcard.com/badge/github.com/standardbeagle/lci)](https://goreportcard.com/report/github.com/standardbeagle/lci)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- **Sub-millisecond search**: Trigram-based indexing with <5ms search guarantee
+- **Multi-language support**: Go, TypeScript, JavaScript, Python, Rust, C#, PHP, and more
+- **MCP integration**: Model Context Protocol server for AI assistant integration
+- **Semantic search**: Natural language queries with intelligent matching
+- **Call graph analysis**: Track function calls, references, and dependencies
+- **Semantic annotations**: `@lci:` vocabulary for marking up code with metadata
+
+## Installation
+
+### npm (recommended)
+
+```bash
+npm install -g @standardbeagle/lci
+```
+
+### pip
+
+```bash
+pip install lightning-code-index
+```
+
+### Homebrew (coming soon)
+
+```bash
+brew install standardbeagle/tap/lci
+```
+
+### From Source
+
+```bash
+go install github.com/standardbeagle/lci/cmd/lci@latest
+```
+
+### From Releases
+
+Download pre-built binaries from [GitHub Releases](https://github.com/standardbeagle/lci/releases).
+
+## Quick Start
+
+### CLI Usage
+
+```bash
+# Index and search in current directory
+lci search "handleRequest"
+
+# Find symbol definitions
+lci def UserService
+
+# Find all references to a symbol
+lci refs CreateUser
+
+# Display function call hierarchy
+lci tree main
+
+# Fast grep-style search
+lci grep "TODO|FIXME"
+
+# List files that would be indexed
+lci list
+```
+
+### MCP Server
+
+Start the MCP server for AI assistant integration:
+
+```bash
+lci mcp
+```
+
+#### Claude Code Integration
+
+Add to your `.mcp.json`:
+
+```json
+{
+  "lci": {
+    "command": "lci",
+    "args": ["mcp"],
+    "env": {}
+  }
+}
+```
+
+## Configuration
+
+Create `.lci.kdl` in your project root:
+
+```kdl
+project {
+    name "my-project"
+    root "."
+}
+
+index {
+    include "**/*.go" "**/*.ts" "**/*.py"
+    exclude "**/node_modules/**" "**/vendor/**"
+}
+
+search {
+    max-results 100
+    context-lines 3
+}
+```
+
+## MCP Tools
+
+When running as an MCP server, LCI exposes these tools:
+
+| Tool | Description |
+|------|-------------|
+| `search` | Semantic code search with fuzzy matching |
+| `get_context` | Get detailed context for a code symbol |
+| `find_files` | Fast file path search with glob patterns |
+| `code_insight` | Codebase intelligence and analysis |
+| `context` | Save/load code context manifests |
+| `semantic_annotations` | Query @lci: semantic labels |
+| `side_effects` | Analyze function purity and side effects |
+
+## Semantic Annotations
+
+Mark up your code with `@lci:` annotations for enhanced AI understanding:
+
+```go
+// @lci:risk[high] @lci:public-api
+// @lci:requires[env:DATABASE_URL]
+func HandleUserLogin(w http.ResponseWriter, r *http.Request) {
+    // ...
+}
+
+// @lci:purpose[Validate user credentials against database]
+// @lci:must[Return error for invalid credentials]
+func ValidateCredentials(username, password string) error {
+    // ...
+}
+```
+
+### Annotation Categories
+
+- **Risk & Safety**: `@lci:risk[low|medium|high|critical]`, `@lci:safe-zone`, `@lci:stability`
+- **Dependencies**: `@lci:requires[env:VAR]`, `@lci:requires[db:table]`, `@lci:requires[service:name]`
+- **Conventions**: `@lci:convention[pattern]`, `@lci:idiom[name]`, `@lci:template[name]`
+- **Contracts**: `@lci:must[behavior]`, `@lci:must-not[behavior]`, `@lci:invariant[condition]`
+- **Purpose**: `@lci:purpose[description]`, `@lci:domain[area]`, `@lci:owner[team]`
+
+## Architecture
+
+```
+lci/
+├── cmd/lci/          # CLI entry point
+├── internal/
+│   ├── core/         # Trigram index, symbol store, reference tracker
+│   ├── parser/       # Tree-sitter based multi-language parsing
+│   ├── search/       # Search engine and scoring
+│   ├── indexing/     # Master index and pipeline
+│   ├── mcp/          # MCP server and tools
+│   └── analysis/     # Code analysis and metrics
+└── pkg/              # Public API
+```
+
+## Performance
+
+LCI is designed for speed:
+
+- **Indexing**: <5s for typical projects (<10k files)
+- **Search**: <5ms for most queries
+- **Memory**: <100MB for typical web projects
+- **Startup**: Near-instant with persistent index
+
+## Development
+
+```bash
+# Run tests
+go test ./...
+
+# Build
+go build ./cmd/lci
+
+# Run with race detector
+go test -race ./...
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Contributing
+
+Contributions are welcome! Please read the contributing guidelines before submitting PRs.

lightning_code_index-0.0.0/README.md

@@ -0,0 +1,198 @@
+# LCI - Lightning Code Index
+
+Lightning-fast code indexing and search for AI assistants.
+
+[![CI](https://github.com/standardbeagle/lci/actions/workflows/ci.yml/badge.svg)](https://github.com/standardbeagle/lci/actions/workflows/ci.yml)
+[![Go Report Card](https://goreportcard.com/badge/github.com/standardbeagle/lci)](https://goreportcard.com/report/github.com/standardbeagle/lci)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- **Sub-millisecond search**: Trigram-based indexing with <5ms search guarantee
+- **Multi-language support**: Go, TypeScript, JavaScript, Python, Rust, C#, PHP, and more
+- **MCP integration**: Model Context Protocol server for AI assistant integration
+- **Semantic search**: Natural language queries with intelligent matching
+- **Call graph analysis**: Track function calls, references, and dependencies
+- **Semantic annotations**: `@lci:` vocabulary for marking up code with metadata
+
+## Installation
+
+### npm (recommended)
+
+```bash
+npm install -g @standardbeagle/lci
+```
+
+### pip
+
+```bash
+pip install lightning-code-index
+```
+
+### Homebrew (coming soon)
+
+```bash
+brew install standardbeagle/tap/lci
+```
+
+### From Source
+
+```bash
+go install github.com/standardbeagle/lci/cmd/lci@latest
+```
+
+### From Releases
+
+Download pre-built binaries from [GitHub Releases](https://github.com/standardbeagle/lci/releases).
+
+## Quick Start
+
+### CLI Usage
+
+```bash
+# Index and search in current directory
+lci search "handleRequest"
+
+# Find symbol definitions
+lci def UserService
+
+# Find all references to a symbol
+lci refs CreateUser
+
+# Display function call hierarchy
+lci tree main
+
+# Fast grep-style search
+lci grep "TODO|FIXME"
+
+# List files that would be indexed
+lci list
+```
+
+### MCP Server
+
+Start the MCP server for AI assistant integration:
+
+```bash
+lci mcp
+```
+
+#### Claude Code Integration
+
+Add to your `.mcp.json`:
+
+```json
+{
+  "lci": {
+    "command": "lci",
+    "args": ["mcp"],
+    "env": {}
+  }
+}
+```
+
+## Configuration
+
+Create `.lci.kdl` in your project root:
+
+```kdl
+project {
+    name "my-project"
+    root "."
+}
+
+index {
+    include "**/*.go" "**/*.ts" "**/*.py"
+    exclude "**/node_modules/**" "**/vendor/**"
+}
+
+search {
+    max-results 100
+    context-lines 3
+}
+```
+
+## MCP Tools
+
+When running as an MCP server, LCI exposes these tools:
+
+| Tool | Description |
+|------|-------------|
+| `search` | Semantic code search with fuzzy matching |
+| `get_context` | Get detailed context for a code symbol |
+| `find_files` | Fast file path search with glob patterns |
+| `code_insight` | Codebase intelligence and analysis |
+| `context` | Save/load code context manifests |
+| `semantic_annotations` | Query @lci: semantic labels |
+| `side_effects` | Analyze function purity and side effects |
+
+## Semantic Annotations
+
+Mark up your code with `@lci:` annotations for enhanced AI understanding:
+
+```go
+// @lci:risk[high] @lci:public-api
+// @lci:requires[env:DATABASE_URL]
+func HandleUserLogin(w http.ResponseWriter, r *http.Request) {
+    // ...
+}
+
+// @lci:purpose[Validate user credentials against database]
+// @lci:must[Return error for invalid credentials]
+func ValidateCredentials(username, password string) error {
+    // ...
+}
+```
+
+### Annotation Categories
+
+- **Risk & Safety**: `@lci:risk[low|medium|high|critical]`, `@lci:safe-zone`, `@lci:stability`
+- **Dependencies**: `@lci:requires[env:VAR]`, `@lci:requires[db:table]`, `@lci:requires[service:name]`
+- **Conventions**: `@lci:convention[pattern]`, `@lci:idiom[name]`, `@lci:template[name]`
+- **Contracts**: `@lci:must[behavior]`, `@lci:must-not[behavior]`, `@lci:invariant[condition]`
+- **Purpose**: `@lci:purpose[description]`, `@lci:domain[area]`, `@lci:owner[team]`
+
+## Architecture
+
+```
+lci/
+├── cmd/lci/          # CLI entry point
+├── internal/
+│   ├── core/         # Trigram index, symbol store, reference tracker
+│   ├── parser/       # Tree-sitter based multi-language parsing
+│   ├── search/       # Search engine and scoring
+│   ├── indexing/     # Master index and pipeline
+│   ├── mcp/          # MCP server and tools
+│   └── analysis/     # Code analysis and metrics
+└── pkg/              # Public API
+```
+
+## Performance
+
+LCI is designed for speed:
+
+- **Indexing**: <5s for typical projects (<10k files)
+- **Search**: <5ms for most queries
+- **Memory**: <100MB for typical web projects
+- **Startup**: Near-instant with persistent index
+
+## Development
+
+```bash
+# Run tests
+go test ./...
+
+# Build
+go build ./cmd/lci
+
+# Run with race detector
+go test -race ./...
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Contributing
+
+Contributions are welcome! Please read the contributing guidelines before submitting PRs.

lightning_code_index-0.0.0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "lightning-code-index"
+dynamic = ["version"]
+description = "Lightning Code Index - Sub-millisecond semantic code search and analysis"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+authors = [
+    { name = "Standard Beagle" }
+]
+keywords = ["code-search", "semantic-search", "code-analysis", "mcp", "indexing"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: MacOS",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development",
+    "Topic :: Software Development :: Code Generators",
+    "Topic :: Text Processing :: Indexing",
+]
+
+[project.urls]
+Homepage = "https://github.com/standardbeagle/lci"
+Repository = "https://github.com/standardbeagle/lci"
+Issues = "https://github.com/standardbeagle/lci/issues"
+
+[project.scripts]
+lci = "lci:main"
+
+[tool.hatch.version]
+path = "python/lci/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["python/lci"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/python",
+    "/README.md",
+    "/LICENSE",
+]

lightning_code_index-0.0.0/python/lci/__init__.py

@@ -0,0 +1,76 @@
+"""Lightning Code Index - Sub-millisecond semantic code search and analysis."""
+
+__version__ = "0.0.0"  # Replaced during release
+
+import os
+import platform
+import subprocess
+import sys
+from pathlib import Path
+
+
+def _get_binary_path() -> Path:
+    """Get the path to the lci binary."""
+    # Binary is bundled in the package
+    package_dir = Path(__file__).parent
+
+    system = platform.system().lower()
+    machine = platform.machine().lower()
+
+    # Normalize architecture names
+    if machine in ("x86_64", "amd64"):
+        arch = "amd64"
+    elif machine in ("arm64", "aarch64"):
+        arch = "arm64"
+    else:
+        raise RuntimeError(f"Unsupported architecture: {machine}")
+
+    # Normalize OS names and get binary name
+    if system == "darwin":
+        binary_name = f"lci_darwin_{arch}"
+    elif system == "linux":
+        binary_name = f"lci_linux_{arch}"
+    elif system == "windows":
+        if arch != "amd64":
+            raise RuntimeError(f"Windows only supports amd64, got: {arch}")
+        binary_name = "lci_windows_amd64.exe"
+    else:
+        raise RuntimeError(f"Unsupported operating system: {system}")
+
+    binary_path = package_dir / "bin" / binary_name
+
+    if not binary_path.exists():
+        raise RuntimeError(
+            f"Binary not found at {binary_path}. "
+            "This may be a source installation. "
+            "Please install from PyPI: pip install lci"
+        )
+
+    return binary_path
+
+
+def main() -> int:
+    """Run the lci binary with the given arguments."""
+    try:
+        binary_path = _get_binary_path()
+    except RuntimeError as e:
+        print(f"Error: {e}", file=sys.stderr)
+        return 1
+
+    # Make sure binary is executable on Unix
+    if platform.system() != "Windows":
+        os.chmod(binary_path, 0o755)
+
+    # Run the binary with all arguments
+    result = subprocess.run(
+        [str(binary_path)] + sys.argv[1:],
+        stdin=sys.stdin,
+        stdout=sys.stdout,
+        stderr=sys.stderr,
+    )
+
+    return result.returncode
+
+
+if __name__ == "__main__":
+    sys.exit(main())