contextual-engine 0.1.0__tar.gz

contextual_engine-0.1.0/.contextualignore

@@ -0,0 +1,97 @@
+# .contextualignore - Default patterns for Contextual indexing
+# Uses gitignore syntax (pathspec)
+# Place this in your project root to customize what gets indexed
+
+# Dependencies
+node_modules/
+.venv/
+venv/
+vendor/
+.bundle/
+
+# Build outputs
+dist/
+build/
+*.egg-info/
+target/
+out/
+bin/
+obj/
+
+# Minified/generated files
+*.min.js
+*.min.css
+*_pb2.py
+*_pb2.pyi
+*.g.dart
+*.freezed.dart
+*.g.go
+
+# Type declarations (usually auto-generated)
+*.d.ts
+
+# Database files
+*.db
+*.sqlite
+*.sqlite3
+
+# Logs
+*.log
+
+# IDE/Editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Test coverage
+htmlcov/
+.coverage
+coverage.xml
+
+# Documentation builds
+_build/
+site/
+
+# Large media files (not useful for code context)
+*.mp4
+*.mov
+*.avi
+*.mp3
+*.wav
+*.jpg
+*.jpeg
+*.png
+*.gif
+*.ico
+*.svg
+*.pdf
+
+# Archive files
+*.zip
+*.tar
+*.tar.gz
+*.rar
+*.7z
+
+# Binary files
+*.exe
+*.dll
+*.so
+*.dylib
+
+# Lock files (too noisy, low signal)
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+poetry.lock
+Cargo.lock
+
+# Code generated comments
+# DO NOT EDIT
+# Code generated by
+# Auto-generated

contextual_engine-0.1.0/.git-hooks/post-commit

@@ -0,0 +1,40 @@
+#!/bin/bash
+#
+# Contextual post-commit hook
+# Triggers incremental indexing after each commit
+#
+# This hook runs as a fully detached background process to never block git.
+# It acquires a lock file to prevent concurrent indexing operations.
+
+# Close all file descriptors to fully detach from git
+exec 0<&-         # Close stdin
+exec 1>/dev/null  # Close stdout
+exec 2>/dev/null  # Close stderr
+
+# Check if contextual is available
+if ! command -v contextual &> /dev/null; then
+    exit 0
+fi
+
+# Lock file to prevent concurrent indexing
+LOCK_FILE=".git/contextual-index.lock"
+
+# Try to acquire lock (non-blocking)
+if ! mkdir "$LOCK_FILE" 2>/dev/null; then
+    # Another indexing process is running, skip
+    exit 0
+fi
+
+# Ensure lock is released on exit (even if script crashes)
+trap 'rm -rf "$LOCK_FILE"' EXIT
+
+# Run incremental indexing in background
+# --incremental: only index changed files since last indexed commit
+# --quiet: suppress output (we're detached anyway)
+nohup contextual index --incremental --quiet &
+
+# Disown the background process so it survives shell exit
+disown
+
+# Always exit 0 so git never fails
+exit 0

contextual_engine-0.1.0/.git-hooks/post-rewrite

@@ -0,0 +1,54 @@
+#!/bin/bash
+#
+# Contextual post-rewrite hook
+# Triggers full re-indexing after amend or rebase operations
+#
+# Git passes the rewrite type as $1 (either "amend" or "rebase").
+# This hook runs as a fully detached background process to never block git.
+# It acquires a lock file to prevent concurrent indexing operations.
+
+# Close all file descriptors to fully detach from git
+exec 0<&-         # Close stdin
+exec 1>/dev/null  # Close stdout
+exec 2>/dev/null  # Close stderr
+
+# Get rewrite type from git (either "amend" or "rebase")
+REWRITE_TYPE="${1:-unknown}"
+
+# Only process amend and rebase operations
+case "$REWRITE_TYPE" in
+    amend|rebase)
+        ;;
+    *)
+        # Unknown rewrite type, skip indexing
+        exit 0
+        ;;
+esac
+
+# Check if contextual is available
+if ! command -v contextual &> /dev/null; then
+    exit 0
+fi
+
+# Lock file to prevent concurrent indexing
+LOCK_FILE=".git/contextual-index.lock"
+
+# Try to acquire lock (non-blocking)
+if ! mkdir "$LOCK_FILE" 2>/dev/null; then
+    # Another indexing process is running, skip
+    exit 0
+fi
+
+# Ensure lock is released on exit (even if script crashes)
+trap 'rm -rf "$LOCK_FILE"' EXIT
+
+# Run full re-indexing in background
+# --force: force re-validation of entire index (amend/rebase can change history)
+# --quiet: suppress output (we're detached anyway)
+nohup contextual index --force --quiet &
+
+# Disown the background process so it survives shell exit
+disown
+
+# Always exit 0 so git never fails
+exit 0

contextual_engine-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,49 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  checks:
+    name: ${{ matrix.os }} / py${{ matrix.python-version }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-14]
+        python-version: ["3.12", "3.13"]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Ruff check
+        run: uv run ruff check .
+
+      - name: Ruff format check
+        run: uv run ruff format --check .
+
+      - name: Mypy
+        run: uv run mypy contextual/ --strict
+
+      - name: Pytest
+        env:
+          NUMBA_DISABLE_JIT: "1"
+        run: uv run pytest tests/

contextual_engine-0.1.0/.gitignore

@@ -0,0 +1,105 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Type checking
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+.pytype/
+
+# Linting
+.ruff_cache/
+
+# Testing
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+coverage.xml
+*.cover
+*.log
+
+# Jupyter
+.ipynb_checkpoints
+*.ipynb
+
+# Contextual-specific
+.contextual/
+*.db
+*.db-shm
+*.db-wal
+lance/
+
+# Documentation builds
+docs/_build/
+site/
+
+# Environment files
+.env
+.env.local
+.envrc
+
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Temporary files
+*.tmp
+*.bak
+*.swp
+*~
+
+# Distribution
+*.tar.gz
+*.whl
+.pypirc
+
+# CI/CD
+.github/workflows/*.log
+
+#development markdown files
+AGENTS.md
+CLAUDE.md
+repo_structure.md
+SCAFFOLD_README.md
+output.md
+audit_report.md

contextual_engine-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,20 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.12.0
+    hooks:
+      - id: ruff
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.11.2
+    hooks:
+      - id: mypy
+        args: [--strict, contextual/]

contextual_engine-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

contextual_engine-0.1.0/.uv-cache/.gitignore

@@ -0,0 +1 @@
+*

contextual_engine-0.1.0/.uv-cache/CACHEDIR.TAG

@@ -0,0 +1 @@
+Signature: 8a477f597d28d172789f06886806bc55

contextual_engine-0.1.0/LICENSE

@@ -0,0 +1,111 @@
+BUSINESS SOURCE LICENSE 1.1 (MODIFIED — PRODUCTION-GRADE TEMPLATE)
+
+---
+
+PARAMETERS
+
+Licensor:             [AARJUN MAHULE]
+
+Licensed Work:        [CONTEXTUAL V0.1.0]
+The Licensed Work is (c) [2026] [AARJUN MAHULE]
+
+Additional Use Grant:
+Production Use is permitted solely for:
+
+* Individuals acting for personal, non-commercial purposes
+* Non-commercial projects
+* Organizations with fewer than [5] employees AND annual revenue below [500,000INR]
+
+All other Production Use requires a separate commercial license from the Licensor.
+
+Change Date:          [2030-06-01] (typically four years from first public release)
+
+Change License:       Apache License, Version 2.0
+
+Governing Law:        This License shall be governed by and construed in accordance
+with the laws of Republic of India.
+
+Contact:              [aarjun.mahule23@gmail.com]
+
+---
+
+TERMS
+
+1. Grant of Rights
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, and redistribute the Licensed Work, in whole or in part, for non-production use.
+
+2. Definition of Production Use
+
+“Production Use” means any use of the Licensed Work in a live, operational,
+or business environment, including but not limited to:
+
+* Use in software-as-a-service (SaaS), platform-as-a-service (PaaS),
+  or hosted environments
+* Internal business operations, tools, or workflows
+* Revenue-generating systems or services
+* Customer-facing applications or services
+* Any environment serving real users, customers, or organizational functions
+
+3. Restriction on Production Use
+
+You may not use the Licensed Work for Production Use except as expressly
+permitted under the Additional Use Grant or through a separate commercial
+license agreement with the Licensor.
+
+If your use exceeds the scope of the Additional Use Grant, you must obtain
+a commercial license from the Licensor or cease use immediately.
+
+4. Change License
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor grants you rights under the
+terms of the Change License. On such date, the rights granted under this
+License terminate and are replaced by the Change License.
+
+5. Version Scope
+
+This License applies separately to each version of the Licensed Work.
+Each version may have its own Change Date as specified by the Licensor.
+
+6. Redistribution and Attribution
+
+You must conspicuously display this License and retain all copyright,
+license notices, and attribution in any original or modified copies
+of the Licensed Work.
+
+7. Termination
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+8. Trademarks
+
+This License does not grant you any rights to use the Licensor’s trademarks,
+service marks, or logos, except as required for reasonable and customary use
+in describing the Licensed Work.
+
+9. Disclaimer of Warranty
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED
+ON AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND TITLE.
+
+10. Limitation of Liability
+
+TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL THE
+LICENSOR 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 LICENSED WORK OR THE USE OR OTHER DEALINGS IN THE
+LICENSED WORK.
+
+11. Governing Law
+
+This License shall be governed by and construed in accordance with the laws
+of Republic of India, without regard to conflict of law principles.
+
+---