sharingan-ai 0.1.0__tar.gz

sharingan_ai-0.1.0/.cursor/rules/sharingan.mdc

@@ -0,0 +1,22 @@
+---
+description: Sharingan documentation knowledge graph integration
+alwaysApply: true
+---
+
+# Sharingan Integration
+
+You have access to Sharingan, a knowledge graph of up-to-date documentation for popular tech stacks.
+
+When the user asks about library APIs, framework features, or configuration:
+1. **Always prioritize MCP tools** (`search_docs`, `query_graph`, `get_symbol`) first.
+2. Use the structured results instead of guessing from training data.
+3. Note confidence tags: EXTRACTED (fact) vs INFERRED (inference).
+
+## Project Checkpoint
+This project uses the following specific versions:
+- nextjs: 15.3.2 (Path: libraries/nextjs/versions/15.3.2/)
+- react: 19.1.0 (Path: libraries/react/versions/19.1.0/)
+
+**CRITICAL**: You must strictly prioritize the Sharingan MCP tools to look up documentation for these exact versions.
+
+Covered: React, Next.js, TypeScript, Node.js, Python, FastAPI, PostgreSQL, Tailwind CSS, Prisma, Zod

sharingan_ai-0.1.0/.gitignore

@@ -0,0 +1,34 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+dist/
+build/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Sharingan extraction cache (local only)
+libraries/*/versions/*/cache/
+
+# Test artifacts
+tests/output/
+
+#token
+token.txt

sharingan_ai-0.1.0/LICENSE

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

sharingan_ai-0.1.0/PKG-INFO

@@ -0,0 +1,184 @@
+Metadata-Version: 2.4
+Name: sharingan-ai
+Version: 0.1.0
+Summary: Open-source knowledge graph for latest documentation of popular tech stacks. AI coding assistant plugin for Claude Code, Codex, Cursor, and more.
+Project-URL: Homepage, https://github.com/sharingan-docs/sharingan
+Project-URL: Repository, https://github.com/sharingan-docs/sharingan
+Project-URL: Issues, https://github.com/sharingan-docs/sharingan/issues
+Author: Sharingan Contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai-coding,claude-code,documentation,graphrag,knowledge-graph,mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Documentation
+Requires-Python: >=3.11
+Requires-Dist: beautifulsoup4>=4.12
+Requires-Dist: click>=8.1
+Requires-Dist: httpx>=0.27
+Requires-Dist: jsonschema>=4.20
+Requires-Dist: lxml>=5.0
+Requires-Dist: markdown-it-py>=3.0
+Requires-Dist: networkx>=3.2
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Provides-Extra: all
+Requires-Dist: sharingan[anthropic]; extra == 'all'
+Requires-Dist: sharingan[leiden]; extra == 'all'
+Requires-Dist: sharingan[mcp]; extra == 'all'
+Requires-Dist: sharingan[ollama]; extra == 'all'
+Requires-Dist: sharingan[openai]; extra == 'all'
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.40; extra == 'anthropic'
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Provides-Extra: leiden
+Requires-Dist: igraph>=0.11; extra == 'leiden'
+Requires-Dist: leidenalg>=0.10; extra == 'leiden'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == 'mcp'
+Provides-Extra: ollama
+Requires-Dist: ollama>=0.4; extra == 'ollama'
+Provides-Extra: openai
+Requires-Dist: openai>=1.50; extra == 'openai'
+Description-Content-Type: text/markdown
+
+# Sharingan 👁️
+
+**Open-source documentation knowledge graph for AI coding assistants.**
+
+Turn the latest documentation of popular tech stacks into a queryable knowledge graph — with plugins for Claude Code, Codex, Cursor, Gemini CLI, and more.
+
+> Think of it as: **Context7, but fully open-source.** Or **Graphify, but for external library docs instead of your codebase.**
+
+## Why Sharingan?
+
+AI coding assistants hallucinate outdated APIs. Their training data has a cutoff. Sharingan solves this by maintaining a **live, version-aware knowledge graph** of the documentation for the frameworks you actually use.
+
+| Feature | Context7 | Graphify | **Sharingan** |
+|:--------|:---------|:---------|:--------------|
+| Open-source backend | ❌ | ✅ | ✅ |
+| Documentation focus | ✅ | ❌ (code) | ✅ |
+| Version tracking | ✅ | ❌ | ✅ (last 3 majors) |
+| Offline-first | ❌ | ✅ | ✅ |
+| Graph relationships | ❌ (vectors) | ✅ | ✅ |
+| Migration queries | ❌ | ❌ | ✅ |
+| Confidence tagging | ❌ | ✅ | ✅ |
+
+## Quick Start
+
+```bash
+# Install
+pip install sharingan
+# or
+uv tool install sharingan
+
+# Extract documentation for a library
+sharingan extract zod
+sharingan extract nextjs --version 15.3.2
+sharingan extract react --skip-llm  # Pass 1 only (free, no API key needed)
+
+# Query the knowledge graph
+sharingan query "useRouter" --lib nextjs
+sharingan query "z.string" --lib zod
+
+# Install into your AI assistant
+sharingan install --platform claude
+sharingan install --platform codex
+sharingan install --platform cursor
+```
+
+## How It Works
+
+Sharingan uses a **two-pass extraction pipeline** (inspired by [Graphify](https://github.com/safishamsi/graphify)):
+
+### Pass 1 — Deterministic (Free, No API Calls)
+- Parses markdown/HTML documentation
+- Extracts code blocks, API signatures, parameter tables
+- Identifies heading structure and cross-references
+- **Zero token cost** — runs entirely locally
+
+### Pass 2 — Semantic (LLM-Assisted)
+- Summarizes prose documentation
+- Infers relationships between API symbols
+- Detects deprecation patterns
+- Scores confidence on inferred edges
+- **Auto-detects backend**: Anthropic → OpenAI → Ollama
+
+### Graph Building
+- Merges Pass 1 + Pass 2 into a **NetworkX** directed graph
+- Clusters related APIs into communities via **Leiden algorithm**
+- Exports to JSON files in a git-friendly structure
+- Every edge tagged with confidence: `EXTRACTED`, `INFERRED`, or `AMBIGUOUS`
+
+## Covered Libraries
+
+### Tier 1 (Available Now)
+React, Next.js, TypeScript, Node.js, Python, FastAPI, PostgreSQL, Tailwind CSS, Prisma, Zod
+
+### Tier 2 (Coming Soon)
+Vue.js, Svelte, Django, Express.js, Docker, Supabase, Drizzle ORM, tRPC, Vite, shadcn/ui
+
+### Tier 3 (Planned)
+Angular, Rust, Go, Flask, LangChain, Vercel AI SDK, MongoDB, Redis, Stripe, AWS SDK
+
+## CLI Commands
+
+```bash
+sharingan extract <library>     # Extract docs into knowledge graph
+sharingan list                  # Show all libraries in registry
+sharingan info <library>        # Show library details
+sharingan query <question>      # Query the graph
+sharingan status                # Show extraction statistics
+sharingan install               # Install AI assistant skill
+```
+
+## For AI Assistant Plugin Developers
+
+Sharingan exposes an **MCP server** for direct integration:
+
+```bash
+# Start MCP server (stdio transport)
+python -m sharingan.serve
+
+# Start MCP server (HTTP transport)
+python -m sharingan.serve --transport http --port 8080
+```
+
+### MCP Tools Available
+
+| Tool | Description |
+|:-----|:------------|
+| `resolve_library` | Find library by name |
+| `get_symbol` | Get full API docs for a symbol |
+| `search_docs` | Search guides and symbols |
+| `get_migration` | Get migration guide between versions |
+| `query_graph` | Free-form graph query |
+| `get_neighbors` | Get related nodes |
+| `shortest_path` | Find connection between symbols |
+
+## Contributing
+
+We welcome contributions! The most impactful ways to help:
+
+1. **Add a library** — add an entry to `registry.json` and run the extraction pipeline
+2. **Improve parsing** — better regex patterns for API signature extraction
+3. **Report issues** — if extraction misses or misidentifies an API
+
+```bash
+# Dev setup
+git clone https://github.com/sharingan-docs/sharingan
+cd sharingan
+uv sync --all-extras
+uv run pytest tests/ -q
+```
+
+## License
+
+MIT

sharingan_ai-0.1.0/README.md

@@ -0,0 +1,133 @@
+# Sharingan 👁️
+
+**Open-source documentation knowledge graph for AI coding assistants.**
+
+Turn the latest documentation of popular tech stacks into a queryable knowledge graph — with plugins for Claude Code, Codex, Cursor, Gemini CLI, and more.
+
+> Think of it as: **Context7, but fully open-source.** Or **Graphify, but for external library docs instead of your codebase.**
+
+## Why Sharingan?
+
+AI coding assistants hallucinate outdated APIs. Their training data has a cutoff. Sharingan solves this by maintaining a **live, version-aware knowledge graph** of the documentation for the frameworks you actually use.
+
+| Feature | Context7 | Graphify | **Sharingan** |
+|:--------|:---------|:---------|:--------------|
+| Open-source backend | ❌ | ✅ | ✅ |
+| Documentation focus | ✅ | ❌ (code) | ✅ |
+| Version tracking | ✅ | ❌ | ✅ (last 3 majors) |
+| Offline-first | ❌ | ✅ | ✅ |
+| Graph relationships | ❌ (vectors) | ✅ | ✅ |
+| Migration queries | ❌ | ❌ | ✅ |
+| Confidence tagging | ❌ | ✅ | ✅ |
+
+## Quick Start
+
+```bash
+# Install
+pip install sharingan
+# or
+uv tool install sharingan
+
+# Extract documentation for a library
+sharingan extract zod
+sharingan extract nextjs --version 15.3.2
+sharingan extract react --skip-llm  # Pass 1 only (free, no API key needed)
+
+# Query the knowledge graph
+sharingan query "useRouter" --lib nextjs
+sharingan query "z.string" --lib zod
+
+# Install into your AI assistant
+sharingan install --platform claude
+sharingan install --platform codex
+sharingan install --platform cursor
+```
+
+## How It Works
+
+Sharingan uses a **two-pass extraction pipeline** (inspired by [Graphify](https://github.com/safishamsi/graphify)):
+
+### Pass 1 — Deterministic (Free, No API Calls)
+- Parses markdown/HTML documentation
+- Extracts code blocks, API signatures, parameter tables
+- Identifies heading structure and cross-references
+- **Zero token cost** — runs entirely locally
+
+### Pass 2 — Semantic (LLM-Assisted)
+- Summarizes prose documentation
+- Infers relationships between API symbols
+- Detects deprecation patterns
+- Scores confidence on inferred edges
+- **Auto-detects backend**: Anthropic → OpenAI → Ollama
+
+### Graph Building
+- Merges Pass 1 + Pass 2 into a **NetworkX** directed graph
+- Clusters related APIs into communities via **Leiden algorithm**
+- Exports to JSON files in a git-friendly structure
+- Every edge tagged with confidence: `EXTRACTED`, `INFERRED`, or `AMBIGUOUS`
+
+## Covered Libraries
+
+### Tier 1 (Available Now)
+React, Next.js, TypeScript, Node.js, Python, FastAPI, PostgreSQL, Tailwind CSS, Prisma, Zod
+
+### Tier 2 (Coming Soon)
+Vue.js, Svelte, Django, Express.js, Docker, Supabase, Drizzle ORM, tRPC, Vite, shadcn/ui
+
+### Tier 3 (Planned)
+Angular, Rust, Go, Flask, LangChain, Vercel AI SDK, MongoDB, Redis, Stripe, AWS SDK
+
+## CLI Commands
+
+```bash
+sharingan extract <library>     # Extract docs into knowledge graph
+sharingan list                  # Show all libraries in registry
+sharingan info <library>        # Show library details
+sharingan query <question>      # Query the graph
+sharingan status                # Show extraction statistics
+sharingan install               # Install AI assistant skill
+```
+
+## For AI Assistant Plugin Developers
+
+Sharingan exposes an **MCP server** for direct integration:
+
+```bash
+# Start MCP server (stdio transport)
+python -m sharingan.serve
+
+# Start MCP server (HTTP transport)
+python -m sharingan.serve --transport http --port 8080
+```
+
+### MCP Tools Available
+
+| Tool | Description |
+|:-----|:------------|
+| `resolve_library` | Find library by name |
+| `get_symbol` | Get full API docs for a symbol |
+| `search_docs` | Search guides and symbols |
+| `get_migration` | Get migration guide between versions |
+| `query_graph` | Free-form graph query |
+| `get_neighbors` | Get related nodes |
+| `shortest_path` | Find connection between symbols |
+
+## Contributing
+
+We welcome contributions! The most impactful ways to help:
+
+1. **Add a library** — add an entry to `registry.json` and run the extraction pipeline
+2. **Improve parsing** — better regex patterns for API signature extraction
+3. **Report issues** — if extraction misses or misidentifies an API
+
+```bash
+# Dev setup
+git clone https://github.com/sharingan-docs/sharingan
+cd sharingan
+uv sync --all-extras
+uv run pytest tests/ -q
+```
+
+## License
+
+MIT

sharingan_ai-0.1.0/indexes/by-category.json

@@ -0,0 +1,14 @@
+{
+  "backend": [
+    "fastapi"
+  ],
+  "meta-framework": [
+    "nextjs"
+  ],
+  "runtime": [
+    "nodejs"
+  ],
+  "validation": [
+    "zod"
+  ]
+}

sharingan_ai-0.1.0/indexes/by-language.json

@@ -0,0 +1,12 @@
+{
+  "javascript": [
+    "nodejs"
+  ],
+  "python": [
+    "fastapi"
+  ],
+  "typescript": [
+    "nextjs",
+    "zod"
+  ]
+}