SourceIndex 0.1.0__tar.gz

sourceindex-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+__pycache__/
+*.pyc
+*.pyo
+dist/
+*.egg-info/
+.sourceindex/
+!test_repo/**/.sourceindex/
+.venv/
+venv/
+.env
+
+# backend/ (Cloudflare Worker, JS/TS)
+node_modules/
+.wrangler/
+.pytest_cache/

sourceindex-0.1.0/GETTING_STARTED.md

@@ -0,0 +1,51 @@
+# Getting Started with sourceindex
+
+Hey — and thank you! You're the very first person outside the team to try
+sourceindex, and that genuinely means a lot. I'm really glad you're giving
+it a go.
+
+Anything you notice along the way — good, bad, broken, or just "huh, that's
+weird" — would be hugely helpful to hear. No feedback is too small.
+
+## What it is
+
+When you ask a coding agent to fix or build something, it has to find the
+relevant code first. By default Claude Code does that live, in your session.
+`sourceindex` does it ahead of time so the agent jumps straight to the right
+files.
+
+**Best on an existing repo you didn't fully write yourself.** Not very useful
+on a brand-new empty project.
+
+## Install and set up
+
+You'll need Python 3.10+ and a sourceindex API key (starts with `sk-si-`).
+Ask me — I'll send you one.
+
+**Easiest path:** open this file in Claude Code and tell it "set sourceindex
+up in this repo." It can run the steps for you.
+
+If you'd rather do it by hand:
+
+```bash
+pip install sourceindex
+cd /path/to/your/repo
+sourceindex init
+```
+
+It'll prompt for the key, set up some git hooks plus a Claude subagent, and
+scan your repo. A few minutes, once per repo. If you don't have a `CLAUDE.md`
+yet, run `/init` in Claude Code first.
+
+## Day-to-day
+
+Nothing. Open the repo in Claude Code as usual — it'll use sourceindex on
+its own.
+
+## Feedback I'd love
+
+- Did `sourceindex init` finish cleanly?
+- Does the agent feel different? Even "I can't tell" is useful.
+- Anything in this doc that didn't land.
+
+Thanks!

sourceindex-0.1.0/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: SourceIndex
+Version: 0.1.0
+Summary: Codebase index for agentic coding
+Requires-Python: >=3.10
+Requires-Dist: cryptography>=42
+Requires-Dist: keyring>=24
+Requires-Dist: litellm>=1.50
+Requires-Dist: tree-sitter-c>=0.23
+Requires-Dist: tree-sitter-cpp>=0.23
+Requires-Dist: tree-sitter-go>=0.23
+Requires-Dist: tree-sitter-java>=0.23
+Requires-Dist: tree-sitter-javascript>=0.23
+Requires-Dist: tree-sitter-kotlin>=1.0
+Requires-Dist: tree-sitter-ruby>=0.23
+Requires-Dist: tree-sitter-rust>=0.23
+Requires-Dist: tree-sitter-typescript>=0.23
+Requires-Dist: tree-sitter>=0.23
+Provides-Extra: mcp
+Requires-Dist: mcp<2,>=1.0.0; extra == 'mcp'
+Description-Content-Type: text/markdown
+
+# Getting Started with sourceindex
+
+Hey — and thank you! You're the very first person outside the team to try
+sourceindex, and that genuinely means a lot. I'm really glad you're giving
+it a go.
+
+Anything you notice along the way — good, bad, broken, or just "huh, that's
+weird" — would be hugely helpful to hear. No feedback is too small.
+
+## What it is
+
+When you ask a coding agent to fix or build something, it has to find the
+relevant code first. By default Claude Code does that live, in your session.
+`sourceindex` does it ahead of time so the agent jumps straight to the right
+files.
+
+**Best on an existing repo you didn't fully write yourself.** Not very useful
+on a brand-new empty project.
+
+## Install and set up
+
+You'll need Python 3.10+ and a sourceindex API key (starts with `sk-si-`).
+Ask me — I'll send you one.
+
+**Easiest path:** open this file in Claude Code and tell it "set sourceindex
+up in this repo." It can run the steps for you.
+
+If you'd rather do it by hand:
+
+```bash
+pip install sourceindex
+cd /path/to/your/repo
+sourceindex init
+```
+
+It'll prompt for the key, set up some git hooks plus a Claude subagent, and
+scan your repo. A few minutes, once per repo. If you don't have a `CLAUDE.md`
+yet, run `/init` in Claude Code first.
+
+## Day-to-day
+
+Nothing. Open the repo in Claude Code as usual — it'll use sourceindex on
+its own.
+
+## Feedback I'd love
+
+- Did `sourceindex init` finish cleanly?
+- Does the agent feel different? Even "I can't tell" is useful.
+- Anything in this doc that didn't land.
+
+Thanks!

sourceindex-0.1.0/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "SourceIndex"
+version = "0.1.0"
+description = "Codebase index for agentic coding"
+readme = "GETTING_STARTED.md"
+requires-python = ">=3.10"
+dependencies = [
+    "litellm>=1.50",
+    "tree-sitter>=0.23",
+    # AES-GCM at-rest encryption for the daemon-owned .sourceindex/ store.
+    "cryptography>=42",
+    # OS keychain wrapper. Fallback path to a 0600 file is supported if no
+    # keyring backend is present (Docker, headless CI) — install never fails.
+    "keyring>=24",
+    # Per-language grammars for the languages in build/linerange/treesitter.py
+    # LANG_CFG. Each wheel is ~60-330 KB; collectively ~3 MB vs 183 MB for
+    # the all-in-one tree-sitter-language-pack. Languages added later that
+    # aren't listed here are auto-installed at first use when
+    # SOURCEINDEX_AUTO_INSTALL_GRAMMARS=1.
+    "tree-sitter-c>=0.23",
+    "tree-sitter-cpp>=0.23",
+    "tree-sitter-go>=0.23",
+    "tree-sitter-java>=0.23",
+    "tree-sitter-javascript>=0.23",
+    "tree-sitter-kotlin>=1.0",
+    "tree-sitter-ruby>=0.23",
+    "tree-sitter-rust>=0.23",
+    "tree-sitter-typescript>=0.23",
+]
+
+[project.optional-dependencies]
+mcp = ["mcp>=1.0.0,<2"]
+
+[project.scripts]
+sourceindex = "sourceindex.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["sourceindex"]
+
+# The repo's `.git` is a submodule pointer, so hatchling can't use VCS to scope
+# the sdist and would otherwise sweep in the whole workspace (backend/, logs/,
+# test_repo/, .claude/, …). Restrict it to the package + install metadata.
+[tool.hatch.build.targets.sdist]
+include = [
+    "sourceindex/",
+    "pyproject.toml",
+    "GETTING_STARTED.md",
+]

sourceindex-0.1.0/sourceindex/__init__.py

@@ -0,0 +1,30 @@
+__version__ = "0.1.0"
+
+# Surfaced at the top level so the CLI's argparse setup can use it for
+# --workers help/default without importing the build pipeline (which
+# transitively pulls litellm and inflates `sourceindex statusline` startup
+# from ~20ms to ~2.3s on every render tick).
+REALTIME_MAX_WORKERS = 128
+
+
+# Suppress LiteLLM's bedrock/sagemaker pre-load warnings. They fire at import
+# from litellm.litellm_core_utils.common_utils when botocore isn't installed
+# — a baseline "expected" state for our shipped wheel (we route through
+# OpenAI/Anthropic/OpenRouter, never Bedrock or SageMaker, and don't pull in
+# a 100MB+ botocore just to satisfy that startup probe). Installed at package
+# import so it runs before any submodule imports litellm.
+import logging as _logging
+
+
+class _LiteLLMBotocorePreloadFilter(_logging.Filter):
+    _SUPPRESS = (
+        "could not pre-load bedrock-runtime",
+        "could not pre-load sagemaker-runtime",
+    )
+
+    def filter(self, record: _logging.LogRecord) -> bool:
+        msg = record.getMessage()
+        return not any(s in msg for s in self._SUPPRESS)
+
+
+_logging.getLogger("LiteLLM").addFilter(_LiteLLMBotocorePreloadFilter())