makuykendall/contextlite repository overview

# Build main contextlite binary
make build

# Build SOTA evaluation tool
make build-sota

# Build both binaries
make build-all-local

# Or with custom config
./build/contextlite -config configs/custom.yaml

# Run SOTA evaluation
./build/sota-eval

# Development mode with hot reload
make dev

contextlite/
├── cmd/                       # Executable applications
│   ├── contextlite/           # HTTP sidecar server
│   └── sota-eval/             # SOTA comparison CLI tool
├── internal/                  # Private implementation
│   ├── smt/                   # SMT solver integration (Z3)
│   ├── storage/               # SQLite + FTS5 storage layer
│   ├── features/              # 7D feature extraction & scoring
│   ├── pipeline/              # Main assembly pipeline
│   ├── cache/                 # Multi-level caching system
│   ├── api/                   # HTTP API handlers
│   └── evaluation/            # SOTA evaluation framework
├── pkg/                       # Public API packages
│   ├── types/                 # Core data structures
│   ├── config/                # Configuration management
│   └── tokens/                # Token estimation utilities
├── docs/                      # Technical documentation
├── archive/                   # Historical development artifacts
├── test/                      # Integration tests
├── configs/                   # Default configuration files
└── migrations/                # Database schema migrations

# Core SMT optimization settings
smt:
  solver_timeout_ms: 250        # Hard timeout for SMT solver
  max_opt_gap: 0.05            # 5% optimality gap acceptable
  objective_style: "weighted-sum"  # weighted-sum | lexicographic | epsilon-constraint

# 7D Feature weights (adaptive per workspace)
weights:
  relevance: 0.30              # Query match strength
  recency: 0.20                # Time-based decay
  entanglement: 0.15           # Cross-document concept density
  prior: 0.15                  # Historical selection likelihood
  authority: 0.10              # Document importance
  specificity: 0.05            # Query-document topic alignment
  uncertainty: 0.05            # Score variance (subtracted)

curl -X POST http://localhost:8080/api/v1/context/assemble \
  -H "Content-Type: application/json" \
  -d '{
    "query": "How does user authentication work?",
    "max_tokens": 4000,
    "max_documents": 10,
    "use_smt": true,
    "workspace_path": "/path/to/project"
  }'

# Add document
curl -X POST http://localhost:8080/api/v1/documents \
  -H "Content-Type: application/json" \
  -d '{
    "content": "...",
    "path": "src/auth.go",
    "language": "go"
  }'

# Search documents
curl "http://localhost:8080/api/v1/documents/search?q=authentication&limit=20"

# Get workspace weights
curl "http://localhost:8080/api/v1/weights?workspace=/path/to/project"

# Update weights based on feedback
curl -X POST http://localhost:8080/api/v1/weights/update \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_path": "/path/to/project",
    "accepted_docs": ["doc1", "doc2"],
    "rejected_docs": ["doc3"]
  }'

maximize: Σ(α₁·Rel + α₂·Rec + α₃·Ent + α₄·Prior + α₅·Auth + α₆·Spec - α₇·Unc)
subject to: token_budget, max_documents, coherence_constraints

objective_style: "lexicographic"

objective_style: "epsilon-constraint"

# Run full SOTA comparison
./build/sota-eval

# With custom parameters
./build/sota-eval -queries 1000 -docs 100 -verbose

# Install dependencies
make deps

# Build main binary
make build

# Build SOTA evaluation tool
make build-sota

# Build both binaries locally
make build-all-local

# Build for all platforms
make build-all

# Run tests
make test

# Run with coverage
make coverage

# Run benchmarks  
make bench

# Code quality checks
make check

# Development with hot reload
make dev

# Clean build artifacts
make clean

# Build image
make docker-build

# Run container
make docker-run

# Health check
curl http://localhost:8080/health

# Storage statistics
curl http://localhost:8080/api/v1/storage/info

# SMT solver performance
curl http://localhost:8080/api/v1/smt/stats

# Cache performance
curl http://localhost:8080/api/v1/cache/stats